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Introduction 





This manual contains a detailed description of the ROM Basic Input/Output System (BIOS) of the HP 
Vectra ES, QS, and RS series of personal computers. Entry points, including the industry standard ROM 
BIOS entry points and function calls, are documented in this manual. 


This manual deals extensively with programming and programming concepts. It presumes that the reader 
is familiar with the Microsoft Macro Assembler (MASM), and the Intel iAPX 80286 (HP Vectra ES 
series) and iAPX 80386 (HP Vectra QS and RS series) processor architecture. 


Terms Used In This Manual 


In this manual, the term CPU (Central Processing Unit) will be used to refer to both the 80286 and 
80386 processors when a function or operation described is exactly the same for both. Other 
abbreviations, acronyms, and terms used throughout this volume are listed in a glossary at the back of 
this volumn. Related documents which may be of interest to programmers and advanced users are also 
listed at the end of this volume in the "References" section. 


System Software 

Software operating on the system may be viewed as a three-level hierarchy: application programs, 
operating system, and ROM BIOS. These three levels are defined as follows: 

Application Programs 

An application program is the top level of software. It performs application-specific functions (i.e., 
spreadsheet or word processing functions). Application programs rely on either DOS or the ROM BIOS for 
system functions such as character or disc I/O. 

Operating System 

The operating system provides the control and support functions necessary for an application program to 
be executed. The operating system provides file-oriented functions, as well as providing basic support for 
character I/O. 

ROM BIOS 

The ROM BIOS provides the interface between operating system software and the hardware. The ROM 


BIOS provides a dual function; it constitutes the low level interface between the hardware and operating 
system, as well as providing extended functions to application programs. 
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The higher the software level, the more powerful the functions provided by the software. However, along 
with this power often comes additional overhead which reduces performance and flexibility. A system 
programmer should choose the level of software interface required by the individual set of design 
constraints. It is good programming practice to use the highest level of system software that gets the job 
done. Some system functions can be performed only on the highest level, since only system software 
supports the function. However, other system functions may be performed at more than one level. Using a 
lower level such as the ROM BIOS provides improved speed of execution and additional flexibility. Using 
ROM BIOS routines may affect program portability to future HP products, and to other 
industry-standard PCs. 


The ROM BIOS provides a powerful set of system functions, allowing application programs full access to 
the capabilities of the system while maintaining a hardware-independent interface. The ROM BIOS also 
allows the programmer or system designer to tailor the system to a specific set of design constraints. Some 
of the tailoring methods provided to the programmer are: 


a The number of interrupts can logically expand to fit requirements. 


= Adapter cards can obtain a limited amount of RAM from the system BIOS without installing device 
drivers. 


= Applications can expand the features of the keyboard without replacing the industry standard driver 
(INT 16H). 


These methods maintain application compatibility with minimal effect on system performance. 
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ROM BIOS Overview 





The ROM BIOS is divided into two components, the Standard BIOS (STD-BIOS) and the Extended BIOS 
(EX-BIOS). The STD-BIOS supports the industry standard set of BIOS functions The EX-BIOS is unique 
to the original HP Vectra PC as well as to the HP Vectra series of PCs discussed in this manual. It 
provides a wide range of system functions and support for HP peripherals. The STD-BIOS and the 
EX-BIOS are contained in the system ROM which resides at the top of system memory. 





NOTE 


Throughout the remainder of this manual the terms ROM BIOS, STD-BIOS, 
and EX-BIOS will be used. STD-BIOS and EX-BIOS are defined above. 

The term ROM BIOS will be used to indicate the union of STD-BIOS and 
EX-BIOS. As mentioned before, the term CPU (Central Processing Unit) 
will refer to both the 80286 and 80386 series of processors. 





This chapter contains an overview of the components of the ROM BIOS. These components are the 
interrupt (also called "INT") vectors, code modules, and data structures. Interrupt vectors form the link 
between the operating system, applications, and the ROM BIOS. The code modules perform the ROM 
BIOS functions. Data structures provide the means for the ROM BIOS (and to some extent the 
applications) to maintain driver variables, data buffers, etc. 


Memory Locations 


Code modules are accessed through interrupt vectors. The interrupt vectors reside in the first 1KB of 
system RAM. Usually a code module has an associated data structure. The data structures for the 
STD-BIOS code modules reside in system RAM in absolute memory locations 00400H through OOSFFH. 
The data structures for the EX-BIOS code module reside at the top of system RAM. The address of the - 
EX-BIOS data area will vary depending on the particular configuration of the system. 


Figure 2-1 shows the components of the ROM BIOS and their location within the system memory. Each 
of the ROM BIOS components is discussed in detail in the remainder of this chapter. 


ROM BIOS Overview 2-1 
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* The length of the operating system Is revision dependent. 
** The Top of Available RAM is dependent on system configuration; 
in a 640 KB system it is usually O9FOCOH. Refer to the corresponding 
hardware TRM for more information. 
*** The Top of RAM is dependent on system configuration; 
in a 640 KB system it is O9FFFFH. Refer to the corresponding 
hardware TRM for more information. 
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Figure 2-1. Memory Map Block Diagram 


Interrupts 


The interface to the ROM BIOS is through the interrupt structure of the CPU. The system allows for 
three types of interrupts. 


a Processor Interrupts~-These interrupts allow system software to recover from error conditions and 
other hardware exceptions. 


a Hardware Interrupts--These interrupts are generated by two compatible (8259A) interrupt 
controllers integrated into a VLSI chip (P/N 82C206) located on the Processor PCA. Hardware 
interrupts indicate that a system hardware component or peripheral requires service. 


m= Software Interrupts--These interrupts are generated through the software "INT n" instruction. 
Software interrupts allow system functions to be quickly and easily called by any program. 


Interrupt vectors for the processor interrupts are defined by the CPU. Interrupt vectors for the hardware 
interrupts are mapped by the values programmed into the 8259A interrupt controllers which are 
initialized by the ROM BIOS. Processor and/or hardware interrupts may be simulated by a software 
interrupt mapped to the same interrupt vector. For example, Interrupt 0 is mapped by the CPU for 
Divide-by-O error. The service routine for this error condition may be executed by an INT 0 instruction. 


Each interrupt has an interrupt vector associated with it. The interrupt vector contains the Code Segment 
and Instruction Pointer of the service routine for that interrupt. Each of these vectors consists of two 
words (four bytes). The CPU architecture supports 256 interrupt vectors which occupy the first 1024 
bytes (OQOO00H-003FFH) of system memory. | 
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The interrupt vectors maintain industry standard compatibility while offering the expanded capabilities of 
the HP EX-BIOS functions. Table 2-1 lists the interrupt vector assignments. 


In order for the system to function properly, processor and hardware interrupt vectors are initialized to 
valid service routines. Most unused vectors point to a null routine in the BIOS, which issues an 
End-of-Interrupt (EOI) signal to the 8259A interrupt controllers (when required) and returns. The 
Keyboard Break and Timer Tick software interrupt vectors point to an interrupt return (IRET) 
instruction in the BIOS. These vectors are indicated by an IRET in Table 2-1. Several software vectors 
are used as pointers to data blocks instead of interrupt service routines. These vectors are indicated by an 
interrupt vector used as a pointer to data (PT) in Table 2-1. 


0 


Table 2-1. Interrupt Vector Assignments 


Address Type/ Service 
Routine* 


















































000-003H Divide by Zero STD-BIOS 
1 004-007H Single Step STD-BIOS 
2 008-O00BH Nonmaskable -STD-BIOS 
Interrupt 
00C-00FH Breakpoint STD-BIOS 
010-013H Arithmetic STD-BIOS 
Overflow 





















014-017H Print Screen STD-BIOS 
018-01BH Invalid Opcode STD-BIOS 
01C-01FH Reserved STD-BIOS 
020-023H Timer Interrupt 











024-027H _ Keyboard ISR STD-BIOS 
(IRQ 1) 


Reserved (IRQ 2) 













028-02BH STD-BIOS 

























































































02C-02FH Serial Port 1 STD-BIOS 
al ISR (IRQ 3) 

030-033H Sas Serial Port 0 STD-BIOS 
3 naet aa SG ISR (IRQ 4) 

034-037H Printer Port 2 STD-BIOS 
ISR (IRQ 5) 

038-03BH Flexible Disc STD-BIOS 
ISR (IRQ 6) 

03C-03FH Printer Port 1 STD-BIOS 
ISR (IRQ 7) 

040-043H Video STD-BIOS 

044-047H Equipment Check STD-BIOS 

048-04BH Memory Size STD-BIOS 


04C-04FH Flexible Disc/ STD-BIOS 









































Hard Disc 
050-053H Serial STD-BIOS 
054-057H System Functions STD-BIOS 
058-O0SBH Keyboard STD-BIOS 
05C-05FH Printer STD-BIOS 
060-063H Reserved STD-BIOS 
064-067H Boot STD-BIOS 
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Table 2-1. Interrupt Vector Assignments (Cont.) 


068-06BH 
06C-06FH 
070-073H 
074-077H 
078-07BH 
07C-07FH 
080-083H 
084-087H 
088-08BH 
08C-08FH 


090-093H 
094-097H 


098-09BH 
09C-09FH 


0A0-O0CBH 
0CC-OCFH 


O0DO-OFFH 
100-103H 


104-107H 


108-117H 
118-11BH 


11C-17FH 
180-19FH 


1A0-1BBH 


IBC-1BFH 


1C0-1C3H 


1C4-1C7H 


1C8-1CBH 
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Time and Date 

Keyboard Break 

Timer Tick 

Video Parameter 
Table 

Flexible Disc 
Parameter Table 

Graphics Character 
Table 


Program Terminate 


DOS Function Calls 

DOS Terminate 
Address 

DOS <CTRL>- 
<Break> Address 

DOS Critical Error 

DOS Absolute Disc 
Read 

DOS Absolute Disc 
Write 

DOS Terminate 
Stay Resident 

Reserved for DOS 

Mouse (RAM 
driver) 

Reserved for DOS 

Alternate Flexible 
Disc 

Hard Disc 
Parameter Table 

(0) 

Reserved 

Hard Disc 
Parameter Table 

(1) 

Reserved 

Reserved for User 

Programs 
Programs 

Unused 

Default EX-BIOS 
Entry Point 

Real-time Clock 
ISR (IRQ 8) 

SW Redirected 
(IRQ 9) 

Reserved (IRQ 10) 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
DOS 


DOS 
DOS 


N/A 


DOS 
STD-BIOS 


STD-BIOS 


STD-BIOS 
STD-BIOS 


STD-BIOS 
N/A 


N/A 
EX-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 





Table 2-1. Interrupt Vector Assignments (Cont.) 


Address Type/ Service 
Routine* 


1CC-1CFH Reserved (IRQ 11) STD-BIOS 
















































1D0-1D3H HP-HIL (default EX-BIOS 
IRQ 12) 

1D4-1D7H Coprocessor STD-BIOS 
(IRQ 13) 

1D8-1DBH Hard Disc ISR STD-BIOS 
(IRQ 14) 




















1DC-1DFH Reserved (IRQ 15) STD-BIOS 
1E0-1FFH Not Used N/A 
200-3C3H Reserved N/A 
3C4-3FFH Not Used N/A 


* PI--Processor interrupt 
HW--Hardware interrupt 
SW--Software interrupt 
PT--Interrupt vector used as pointer to data 
N/A--Not applicable 


(1) UI--Unused interrupt ISR 
(2) DRVR--Application callable entry point 
(3) IRET--Interrupt return 


ROM BIOS Drivers and Functions 


The ROM BIOS is comprised of many drivers. For example, there is a driver to perform video functions, 
one to perform disc functions, etc. The ROM BIOS drivers are organized into two components. One 
component contains the STD-BIOS drivers that support the STD-BIOS functions. The second component 
contains EX-BIOS drivers that support unique HP features. 


Each driver supports one or more functions. A function can be viewed as a specific task. For example, the 


Video Driver supports 22 separate functions that perform tasks such as setting the display mode, moving 
the cursor, and displaying characters. 


STD-BIOS Drivers 
Drivers in the STD-BIOS are accessed through an interrupt. STD-BIOS drivers are accessed through 
interrupts OSH and 10H through ICH. Drivers are accessed by performing a software INT n instruction, 


where n is the interrupt number assigned to the driver (refer to Table 2-1.) 


The function code and any required data are passed in the CPU registers. Data passing conventions for 
STD-BIOS drivers vary; however, there are aspects which are common. 
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& Most of the STD-BIOS drivers support. more than one function. Therefore, multi-function drivers 
must have the desired function code passed as part of the data. The AH register is used on all 
multi-function drivers to pass the function code. 


= Byte and word data are passed in the internal registers of the CPU. Registers AL, BX, CX, and DX 
are usually used for this purpose. The register assignments and number of registers used depend on 
the driver and driver function. 


= If the amount of data cannot fit in the internal registers of the CPU, a data buffer in system 
memory is used. This buffer is usually pointed to by ES:BX, ES:BP, or ES:SI. 


a Drivers may modify one or more registers. The registers which are maintained and the registers 
which are modified vary from driver to driver. The registers which are modified are listed in each 
function description. 


Calling STD-BIOS Drivers 


The following program example demonstrates how a typical STD-BIOS driver is accessed. The function 
sets the position of the cursor on display page 0 to row 20, column 10. The function code (02H) is passed 
in register AH. The row position, the column position, and the page number are passed respectively in 
DH, DL, and BH. 


MOV AH,O2H 3;Function number 

MOV DH,14H ;Row number (Row 20) 

MOV DL,OAH ;Column number (Column 10) 
MOV BH,OH ;Page number 

INT 10H 3;Call Video driver 


The STD-BIOS drivers support all industry standard BIOS functions. In addition, many of the drivers 
have functions that support enhanced features. These functions are referred to as "HP extensions" 
throughout the remainder of this manual. These enhancements are accessed through function code 
(default O6FH) of their respective driver. Most of these extended functions are further divided into 
subfunctions. For example, the HP extended function for the Video driver has six subfunctions which 
allow access to the enhanced features of the Multimode Video Display Adapter. The function code 
(O6FH) is placed in the AH register and the subfunction code is placed in the AL register for all HP 
extensions. 


The following program example uses HP extensions to turn off the HP cursor control keypad on the 
Vectra Keyboard/DIN (this keyboard is available for Vectra ES series computers only). 


MOV AH,6FH 3; HP Function 

MOV AL,O7H 3; Switch Keyboard 

MOV BL,O2H 3; Disable CCP: Turn Cursor Control Pad Off 
INT 16H ; Call Keyboard Driver 


We suggest you verify that HP extensions to each STD-BIOS driver are available prior to actually calling 


them. This is accomplished through subfunction O on each driver. An example of this can be found in 
Chapter 3 of this manual under the F10_ INQUIRE (AX = 6FOOH) function description. 
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EX-BIOS Drivers 


The EX-BIOS drivers provide a wide range of functions not found in the STD-BIOS drivers. The — 
EX-BIOS drivers are accessed through a a software interrupt vector called the "HP_ ENTRY" interrupt 
(default 06FH). Since this interrupt number can change from its default, a routine called "CALL 
SYSCALL" should be used in its place. This routine finds and calls the correct HP interrupt number. 


Due to the large number of EX-BIOS drivers, it would be impossible to give each driver its own interrupt 
vector and still maintain industry standard compatibility. Therefore, each driver is assigned its own 
number, which is placed in the BP register. 

The CALL SYSCALL Routine 

The following shows how the CALL SYSCALL routine works: 


aod tie SYSCALL 


Issue an HP system call. This routine assumes that the EX-BIOS 
is enabled. 


When first called, this routine will patch the first instruction 
"JMP SHORT PATCH" to become “INT XXH" where XXH is the current HP 
interrupt number. 


we we we we we we we we 


SYSCALL PROC NEAR 


JMP SHORT PATCH 3; Patch the jump if first time. 
RET 
PATCH: 
PUSH AX 
MOV AX ,6F ODH ; Get current interrupt. 
INT 16H 3; Extended INT 16H call. 
CMP AH,2 ; Is it unsupported. 
JNE PATCH2 ; No, AH is the interrupt number. 
MOV AH ,6FH ; Assume default GFH. 
PATCH2: 
MOV AL ,OCDH ; INT instruction opcode. 
MOV WORD PTR [SYSCALL],AX ; Patch JMP SHORT PATCH above. 
POP AX 3; Recover used register. 
JMP SYSCALL ; Perform the call. 


SYSCALL ENDP 


Calling EX-BIOS Drivers 
As with the STD-BIOS drivers, each EX-BIOS driver may support one or more functions. A function code 


placed in the AH register selects the desired function within the driver. In addition, a subfunction code 
passed in the AL register is required by many EX-BIOS functions. 
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The following program example demonstrates access to a typical EX-BIOS driver. The function executes a 
"beep" on the speaker. 


MOV AH , 3AH ; Function: F_SND BEEP 
MOV BP,12H ; Driver Name: V_SYSTEM 
PUSH DS s 

CALL SYSCALL ; Call EX-BIOS driver 
POP DS : 


On leaving the EX-BIOS driver the BP and DS registers will be modified while the AH register usually 
contains the return status of the driver call. 


It is good programming practice to verify that the EX-BIOS is accessible, and to identify the HP interrupt 
number (once) prior to actually calling it by using the "CALL SYSCALL" routine. 


EX-BIOS Standard Functions 


Many EX-BIOS drivers support a standard set of functions and subfunctions as listed in Table 2-2. While 
these functions and subfunctions are defined, it is not required that they all be implemented by every 
driver. In addition, EX-BIOS drivers may implement functions other than those listed. Most EX-BIOS 
drivers use a standard set of return status codes reported in the AH register at the completion of a 
driver’s function call. Some of these return status codes and their definitions are listed in Table 2-3. 

A driver may return status code of RS UNSUPPORTED (02H) for a given function. 


Function codes and return statuses are described in detail in Appendix G. 


Table 2-2. EX-BIOS Defined Functions 


Function _ Register 
Subfunction Definition AH AL 


F_ISR Responds to a logical Interrupt Service Request 
(ISR). 





















Executes one of several standard subfunctions. 





F_SYSTEM 


Starts the initialization of a driver. 





SF_INIT 


SF START Completes the initialization process of the driver. 








Reports the state of the driver. 





SF_REPORT_STATE 


Reports the revision number and date code of 
the driver. 









SF_VERSION_ DESC 





Reports the default configuration of the driver. 





SF_DEF_ATTR 





SF_GET_ATTR Reports the current configuration of the driver. 








Overrides the current configuration of the 
driver. 





SF_SET_ATTR 
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Table 2-2. EX-BIOS Defined Functions (Cont.) 


Function Register 
Subfunction AH AL 


SF OPEN Reserves the driver for exclusive access. Requests 
any resources required by the driver. 


SF CLOSE Releases the driver from exclusive access. 


SF _ TIMEOUT Reports to the driver that a requested timeout 
has occurred. 


SF INTERVAL Reports to the driver that a requested 60 Hz in- 
terval has expired. 


SF TEST Performs a hardware test. 


F_I0_CONTROL Executes the following subfunctions and any 
driver-dependent subfunctions. 


SF_ LOCK Reserves the sub-address device specified for ex- 
clusive access. 


SF_UNLOCK Releases the sub-address specified from the ex- 
clusive access. 


F_PUT_BYTE Writes a byte of data. 


F_GET_BYTE Reads a byte of data. 


F PUT_BUFFER Writes a variable-length buffer of data (support- 
ed by character devices}. 


F PUT_BLOCK Writes a fixed-length buffer of data (supported 
by block devices). 


F_GET_BUFFER Reads a variable-length buffer of data (support- 
ed by character devices). 


F_GET_BLOCK Reads a fixed-length block of data (supported by 
block devices). 


F PUT_WORD Writes a word of data. 


F GET WORD Reads a word of data. 
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EX-BIOS Parameter Passing Conventions | 


When calling EX-BIOS drivers, the function code is placed in the AH register, and the subfunction code 
(if any): is placed in the AL register. Note that the function and subfunction codes are multiples of two 
in order to facilitate arc cane by the REVERS: 


The generat parameter passing conventions used by the EX-BIOS drivers are also defined. These register 
conventions are as follows: 


On Entry: BP 


AH 

AL 

CX 

ES: DI 

On Exit: AH 
CX 

ES:DI 

~ DS,BP 


V_DRIVER NAME 

F FUNC _CODE.. 

SF_ FUNC _CODE (if er by dciven) 

On write: byte count (if required by driver) 

On read: maximum permissible. byte count 

(if required by driver) 

Buffer pointer or context area (if required by driver) 


Return status 

On read: byte count (if required by driver) 

On write: number of bytes written (if required by driver) 
Buffer pointer or context area (if required by driver) 
Always modified (unless otherwise indicated) 


EX-BIOS Return Status Codes 


EX-BIOS drivers are expected to report a Return Status Code upon completion. This code is eeturnte in 


the AH register. 


Several return status codes have been defined in Table 2-3. 
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Table 2-3. EX-BIOS Return Status Codes 


Return Status Variable Return Status Code 


RS_ SUCCESSFUL 000H 















The requested function ex- 
ecuted correctly. 


The requested function or 
subfunction is not imple- 
mented or is unsupported. 





RS UNSUPPORTED 









RS_ FAIL OFEH (-02H) The driver failed the opera- 


| tion in an error state. 










The driver received a bad 
parameter. 


RS BAD _PARAMETER OFAH (-06H) 












RS_ BUSY OF8H (-08H) The requested driver is busy. 










EX-BIOS Vector table is out 
of RAM or room for more 
drivers. 


RS_NO VECTOR OF6H (-OAH) 











RS_ OFFLINE OF4H (-OCH) Device is offline. 








RS OUT_OF_PAPER OF2H (-OEH) Device is out of paper. 


If additional drivers are installed in the system, they should conform to the defined statuses wherever 
_ possible. However, to maintain coding efficiency and/or functional accuracy, a driver may create a 
return status other than those listed in Table 2-3. 





NOTE 


Return status conditions are always multiples of two. Negative return 
status codes indicate error conditions, while positive status codes indicate 
exceptional conditions to the caller. For example, the status code 

RS_ UNSUPPORTED indicates the driver does not support a function 
which may or may not be an error, while RS_OUT_ PAPER requires some 
kind of response by the caller. 
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Data Structures 


BIOS drivers require RAM data area to perform their functions. The layout and placement of the data 
areas for the STD-BIOS and EX-BIOS drivers differ. This is discussed in the following subsections. 


STD-BIOS Data Structures 


The data area for the STD-BIOS is in absolute memory locations 00400H through OOSFFH, which 
conforms to the industry standard. Table 2-4 summarizes the assignments within this block of memory. 
Refer to Appendix B for a detailed description of these data fields. 


400H-407H 
408H-40FH 
410H-416H 
417H-43DH 
43Eh-448H 
449H-466H 
467H-46BH 
46CH-470H 
471H-473H 
474H-477H 
478H-47FH 
480H-483H 
484H-488H 
489H-48AH 
48BH-48BH 
48CH-48FH 
490H-495H 
496H-497H 
498H-4A0H 
4A 1H-4A7H 
4A 8H-4ABH 
4ACH-4EFH 
4FOH-4FFH 
SOOH-500H 
$01H-503H 
504H-504H 
S505H-SFFH 
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Table 2-4. STD-BIOS Data Area Summary 


Assigned Function 


RS-232 Communication Port Addresses 
Parallel Printer Port Addresses 
Equipment Flag 

Keyboard Data Area 

Flexible Disc Data Area 


Video Display Data Area 


Option ROM Data Area 

Timer Data Area 

System Data Flags 

Hard Disc Data Area 

Printer Time out Counters 

Keyboard Buffer Pointers 

Enhanced Graphics Adapter (EGA) Data Area 
Reserved for Display Adapters 

Flexible Disc Data Rate Area 

Extended Hard Disc Data Area 


| Extended Flexible Disc Data Area 


Keyboard Mode Indicator/LED Data Area 
Real-Time Clock Data Area 

Reserved for Network Adapter Cards 
Pointer to EGA Data Area 

Reserved 

Intra-application Communication Area 
Print Screen Status 

Reserved 

DOS Data Area 

Reserved 








EX-BIOS Data Structures 


Data structures for the EX-BIOS drivers are located in a block of memory at the top of system RAM. 
The address of this block varies depending on the amount of RAM contained in the system and the 
hardware configuration. 


There are three types of data structures in the EX-BIOS data area. These structures are: the 
HP_VECTOR_ TABLE and its associated HP_ENTRY_ CODE, the driver data areas, and the EX-BIOS 
global data area. 


The HP_VECTOR_ TABLE 


Each of the CPU interrupt vectors contains the Code Segment default (CS) and Instruction Pointer (IP) 
of its associated service routine. The HP_ENTRY interrupt vector (default O06FH) contains the CS:IP of 
the HP_ENTRY_ CODE. This routine uses the value contained in the BP register (an offset into the 
HP_VECTOR_ TABLE, vector address) to branch to the appropriate EX-BIOS driver. The 
HP__VECTOR_ TABLE resides at the base of the EX-BIOS data area. The HP_VECTOR_ TABLE consists 
of an array of 3-word (six bytes) entries, one for each EX-BIOS driver. Each entry consists of the IP, CS, 
and Data Segment (DS) of a driver. 


Figure 2-2 illustrates the relationship between the CPU interrupt vectors, the HP_VECTOR_ TABLE, 
HP_ENTRY_ CODE, and the EX-BIOS drivers. 


The HP_ ENTRY_ CODE 


The CS:IP in the HP_ ENTRY interrupt vector points to a piece of code which branches to the desired 
EX-BIOS driver. The vector address passed in BP must be a multiple of six. The code is as follows: 


HP_ENTRY_ CODE: 
MOV DS CS: [BP+4] 
JMP FAR PTR CS: [BP] 


This code resides directly after the last entry in the HP_VECTOR_ TABLE. Therefore, the CS:IP entry 


in the HP_ENTRY interrupt vector provides two further pieces of information. CS:0 is the starting 
address of the HP_VECTOR_ TABLE and IP is the length of the HP_VECTOR_ TABLE. 
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HP_VECTOR_ 
TABLE 


INTERRUPT 
VECTORS 








* This value may-change. Refer to ‘The CALL SYSCALL Routine" 
in this chapter to determine the correct value. 


Figure 2-2. Interrupt Vectors and HP_VECT OR__TABLE 


Driver Data Areas 


Each driver has an independently specified data area. Some EX-BIOS drivers share the same data areas. 
The data areas for the EX-BIOS drivers are above the HP_VECTOR_ TABLE and the 

HP _ENTRY_CODE shown in Figure 2-2. Although each driver has its own data area, the DS for each 
driver is stored in the HP_VECTOR_ TABLE, and its data area must start at DS:0. Each data area must 
reside on a paragraph boundary. . 


The data area for each driver consists of a driver header, followed by an optional variable storage area. 
The variable storage area is unique to each driver. Table 2-5 provides a general description of the 
contents of an EX-BIOS driver header. 






DH_ATR 


DH_P_CLASS 
DH_C_ CLASS 
DH_V_ PARENT 
DH_V_ CHILD 
DH MAJOR 
DH _ MINOR 
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DH_NAME_ INDEX 
DH_V_DEFAULT 





Table 2-5. HP_DRIVER_HEADER | 


Offset Description 


Driver Attribute Field 

Driver String Index Field 
Driver’s Default Logical Device 
Vector 

Driver’s Parent Class 

Driver’s Child Class 

Driver’s Parent Vector 

Driver’s Child Vector 
Sub Address Field 
Sub Address Field 







































EX-BIOS Driver Headers 


The following defines each of the EX-BIOS driver header fields. Additional information on these fields 
can be found in Appendix G. 


DH_ ATR: ..-. Each bit in the DH_ ATR field indicates a property of the 
driver for device mapping purposes. These bits are defined in 
Appendix G. ; 

DH_NAME_ INDEX: The DH_ NAME_INDEX is used to derive the localization 


string index of ‘the driver. This string index is given by the 
function F_STR. GET_STRING in the V_SYSTEM driver. 
See Chapter 8 for additional information. 


DH_V_DEFAULT:. . The DH_V_ DEFAULT field contains the driver’s default vec- 
tor address. 

DH_P_CLASS and In conjunction, these fields indicate which drivers may be 

DH _C_ CLASS: | mapped together. DH_P_ CLASS and DH_C__CLASS are bit 


masks. Each bit position represents a set of drivers. If a bit is 
set, then the driver is in that set of drivers. The 

DH_P_ CLASS field indicates a driver is in from 0 to 16 dif- 
ferent driver sets. A driver can only map to another driver if 
its DH_P CLASS field matches at least one bit position of 
the other driver’s DH_C__CLASS field. Furthermore, the 
DH_ATR field is another condition of mapping. The bits are 
defined in Appendix G. 


DH_V_ PARENT: The DH_V_ PARENT field contains a vector to the driver 
that is called when the current driver receives an F_ISR func- 
tion code that it cannot or doesn’t know how to process. 

DH_V_CHILD: The DH_V_ CHILD field contains a vector to the driver that 
is called if this driver decides it cannot handle the request 
function (as long as that function is not F_ISR). 


DH_MAJOR and DH_ MINOR: Device bus address information. 
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EX-BIOS Global Data Area 


The method for locating the EX-BIOS global data area is found in the "EX -BIOS Data Area Map" of 
Appendix B. The EX-BIOS global data area is shared between several EX-BIOS drivers. It contains 
temporary and permanent variables that are required by the BIOS to function properly. Some of these 
variables can be modified by application programs. As with any modification to the STD-BIOS data area, 
care should be taken with the EX-BIOS global data area. Table 2-6 defines the contents of this area. 


Table 2-6. Definition of Global Data Area Contents 


Reserved 


T_STR_ NEXT _ INDEX Next unused string index 
number. 


20H and up Reserved 
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Video 





The HP Multimode Video Display Adapter provides a wide variety of display modes, resolution, character 
attributes, and other features. The purpose of the video driver is to allow programs to access these 
features and control the video display. 


Overview 


In the text mode, the Multimode Video Display Adapter uses an 8 x 16 character cell which generates 
high quality characters. Access to the display memory is fully synchronized to eliminate the "snow" 
problem present in many color display adapters. (Snow occurs when writing a character to display 
memory while the video memory is being accessed by the display refresh circuitry.) This full 
synchronization makes the INT 10H video driver faster, since there is no need to wait for a vertical 
retrace to place characters on the screen. 


The Multimode Video Display Adapter provides seven more display modes than the industry standard 
color graphics adapter. Four of the modes allow 27 lines of text on the screen. The other three modes 
allow graphics modes that double the graphics resolution of the display (320x400 and 640x400 pixels). 
The standard INT 10H video driver has been extended to allow the programmer to set these modes. No 
other support is provided to make use of these modes. Refer to HP Vectra Accessories Technical Reference 
Manual (for either the Vectra ES or RS) for more information on the Multimode Video Display Adapter. 


Data Structures 


The Multimode Video Display Adapter has 32KB of video memory starting at address OB8000H. This 
allows graphics resolutions of 320x400 in medium resolution modes and 640x400 in high resolution 
modes. The following is a discussion of how this memory is organized, depending on the video mode 
selected. 


In either of the text modes (80x25 or 40x25), memory is organized as sequential pages. Each page 
contains character cells that are made up of an 8-bit character code and an 8-bit attribute (see Figure 
3-1). 


Graphics modes can be of two types: medium resolution (320x200 or 320x400) and high resolution 
(640x200 or 640x400). In the medium resolution mode, each pixel corresponds to two bits of memory, so 
four colors can be displayed. In the high resolution modes, each pixel corresponds to one bit of memory, 
and only one. color can be displayed (the background color is always black). See Figures 3-2 and 3-3 for 
more details. 
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Color Values 


Character Cell Organization 
Byte 0 


Byte 1 
Pe CO COOGGE 





000 0 Black 
8 Bit Char Code 0001 Blue 
0010 Green 
Blink bit 0.0 4~.41 Cyan 
1 = Blinking on 0100 Red 
0 = Blinking off o 10 1 Magenta 
01410 Brown 
Background color o1 1-4 Light Grey 
100 0 Dark Grey 
Intensity bit 1001 Light Blue 
1 High 101 0 Light Green | 
0 =Low 101 1 Light Cyan 
1100 Light Red 
Foreground color 16101 Light Magenta 
1 $11 «0 Yellow 
11141 White 
80 x 25 Text Memory Page 
Coll 0 Cell1 Cell 79 
rawo [oes om] dd 
0B800:0H ae 
Row 24 
ee 7 ae (ceca NE re Sel NM 6, 
(0B800:0FAOH) see 
Figure 3-1. Text Display Memory Organization 
320 x 200 Graphics Display Memory an ine 
0 
2 
4 
1 
3 
5 
; Writing to theee addresses 
Not Accessible actually writes to addresses 
0B800:0H through 08800:3FF FH 





Byte / Pixel Organization 





Figure 3-2. 320 x 200 Graphics Display Memory Organization 


3-2 Video: 





640 x 400 Graphics Display Memory iene 


cascosh[ @uo]omi [owe] «dL own] 
pet oe ee eed 


ccsooxooon| eo [emi [awe] == [own] « 
cman eee any 


eek OoaEEeI EE oerET 





Byte / Pixel Organization 


76 5 43 2 1 «0 bit number 


012 3 4 5 6 7 pixel number 


0 - Background Color (Black) 
1 - 1 .0f 16 Foreground Colors 


Figure 3-3. 640 x 400 Graphics Display Memory Organization 


In all the graphics modes, the memory used for scan lines is not sequential but it is interleaved at fixed 
intervals of 8K. In the modes that are 200 scan lines, even scan lines start at offset O and odd scan lines 
start at offset 2000H. In the modes that are 400 scan lines, the following table can be used to determine 
the appropriate offset: 


Scan line is 


Scan line is 


Scan line is 


Scan line is 


multiple of 4 

(0,4,8,12 ...) use offset 0 
multiple of 4 plus 1 

(1,5,9,13 ...) use offset 2000H 
multiple of 4 plus 2 
(2,6,10,14...) use offset 4000H 
multiple of 4 plus 3 
(3,7,11,15...) use offset 6000H 


All the scan lines of a particular group are organized sequentially within a particular offset. See Figures 


3-2 and 3-3. 


Other video driver data structures are located in the STD-BIOS data area. They are stored in memory 
addresses 449H (40H:49H) through 466H («0i11:66H). Table 3-1 lists the STD-BIOS Video Driver 
memory locations and their definitions. 
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00449H 
0044AH 
0044CH 
0044EH 
00450H 
00452H 
00454H 
00456H 
00458H 
0045AH 
0045SCH 
0045EH 
00460H 
00462H 
00463H 
00465H 
00466H 


Table 3-1. STD-BIOS Video Driver Data Area 


Current Video Display Mode 
Number of columns 

Regen Buffer length 

Starting address of regen buffer 
Cursor position for Display Page 0 
Cursor position for Display Page 1 
Cursor position for Display Page 2 
Cursor position for Display Page 3 
Cursor position for Display Page 4 
Cursor position for Display Page 5 
Cursor position for Display Page 6 
Cursor position for Display Page 7 
Current cursor mode 

Active page number 

Address of current display adapter 
Mode (current setting of status register) 
Pallet setting 





Video data structures are also maintained in the EX-BIOS data area. These structures are accessible 
through the data segment of the EX-BIOS video service routine. The following code sets the ES register to 
the EX-BIOS video driver’s (V_SVIDEO’S) data segment: 


MOV 
MOV 
MOV 


MOV 
MOV 
MOV 


Ax,0 
ES , AX 
AX,ES: 


ES , AX 
AX,ES: 
ES , AX 


NOTE 


The current value of HP_ ENTRY must be determined once using the 
“CALL SYSCALL" routine. 


[HP_ENTRY#4+2] 


[V_SVIDEO+4] 


;segment at 0 
3 . 
;read the base address 

30f the HP_VECTOR TABLE 


;read base address of (V_SVIDEO = 54H) 
3;video parameters . 


The addresses listed are offsets into this data segment. Table 3-2 gives the data maintained in 
V_SVIDEO’s (0054H) data segment: 
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Table 3-2. Video EX-BIOS Data Structures 


Driver Header © Device Header Attributes, 
Name, Index, and Default 
Vector 















The current primary display: 

00 - Card at I/O Address 3BOH 
Ol - Card at I/O Address 3COH 
02 - Card at I/O Address 3D0H 
03 - Card containing ROM 
Code. 





VID_ PRIMARY 











VID_ SECONDARY If two cards are in the system, 
same number as 
VID_ PRIMARY for the second 


card. 









VID_ FOUND_ROM Flag set to true if ROM code is 


found in any video adapter card. 






of IDs of all cards found. 9-0CH 








VID_IDS 





0D-010H 









VID_STATUS RAM copies of the status 


register. 






RAM copies of the extended 11-014H 
status register for each possible 


card in the system. 









VID_EXT_STATUS 







Reserved for saving the video 
parameters stored in the stan- 
dard BIOS data area when 
switching between primary and 
secondary video boards. 





VID_PARM_BLOCK 















Used to detect if a ’rogue’ 
program changed the modes 
without telling the HP system. 





VID_LAST _IBM_MODE 









03DH 






Specifies the current video mode 
(O... 15). 





VID_EXT_MODE 








Reserved 03E-03F 
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Video Driver (INT 10H) 


The video driver f unctions (summarized in Table 3-3) can be broken down into the following categories. 


= Display Control--These functions enol the aiesiag appearance, cursor and light pen poston, 
active text memory page, and scrolling through text memory. 


m= Character Handling Functions--These functions manipulate characters on the screen. 
= String Functions--These functions allow placement of strings of text on the screen. 


= Graphics Functions--These functions provide an interface to the graphics capabilities of the 
machine. 


m Extended Video Functions--These functions support extra video capabilities of the Multimode Video 
Display Adapter hardware. 


Table 3-3. Video Driver Function Code Summary 


i Jinition 


Set video mode 



























































00H _ Fi0_SET_MODE 



















01H F10_ SET _CURSIZE Set cursor size 
02H Fi10_SET_CURPOS Set cursor position 
03H F10_ RD CURPOS Read cursor position 
04H F10_ RD _PENPOS Read light pen position 
05H F10_SET_PAGE Set active display page 
06H F10_SCROLL_UP Scroll rectangle up 
07H - F10_SCROLL_DN Scroll rectangle down 
08H F10_ RD CHARATR Read character and attribute at cursor position 
09H F10 WR _CHARATR Write character and attribute at cursor position 
OAH F110 WR _CHARCUR Write character at cursor position 
OBH F10_SET_PALLET Set color pallet 
OCH F10 WR_ PIXEL | Write pixel 
ODH F10_ RD_ PIXEL Read pixel 
OEH FiO WR _CHARTEL Write teletype character 
OFH F10_GET_STMODE Get video state and mode 
10H-12H Reserved 








Write string functions: 
Fi0O_WRS_00 

F10_ WRS_ Ol 

F10_ WRS 02 
 F10_WRS_ 03 






















1300H 
1301H 
1302H 
1303H 


Global attribute | 
Global attribute, move cursor 
Individual attributes 

Individual attributes, move cursor 














Extented video functions: 

















6F00H 


F110 INQUIRE EX-BIOS present 
6F01H F10 GET_INFO Get video parameters 
6F02H FiO SET_INFO Sets video parameters 
6F03H F10 MOD_INFO Modifies video parameters 
6FO04H F10_ GET_RES Reports video resolution 


6F05H F10_XSET_MODE Sets video resolution 


3-6 Video 


Video Driver Function Definitions 


The following gives a detailed description of each of the functions in the video driver. 


F10 SET MODE (AH = OOH) 


This function sets the display mode of the video adapter. The new mode is determined by the value passed 
in the AL register. Refer to the Vectra Accessories Technical Reference Manual (for either the Vectra ES 
or RS) for additional information on the various video display modes available on the Multimode Video 
Display Adapter. 


On Entry: AH 
AL 


F10 SET MODE (00H) 
Mode 


Data Definition 


00 40 x 25 Black and White Alphanumeric 
01 40x 25 Color Alphanumeric 
02 80 x 25 Black and White Alphanumeric 
03 80 x 25 Color Alphanumeric 
04 320 x 200 Color Graphics 
05 320 x 200 Black and White Graphics 

x 


06 640 200 Black and White Graphics 
07 Only valid if a monochrome display adapter is present. 


On Exit: No values returned 


Registers Altered: AX 


F10 SET _CURSIZE (AH = 01H) 


This function sets the size of the cursor displayed in the alphanumeric display modes. Each character cell 
in the alphanumeric display modes 1s eight scan lines high. The cursor size 1s defined by specifying the 
starting and ending scan lines within the character cell. The scan lines are numbered from 0 (top of cell) 
to 7 (bottom). The starting and ending scan lines are passed in registers CH and CL. This function 
performs no operation if the Multimode Video Display Adapter is in one of the graphics modes. 


On Entry: AH 
CH 
CL 


| F10_ SET CURSIZE (01H) 
Starting scan line 
Ending scan line 


On Exit: No values returned. 


Registers Altered: AH 
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F10_ SET _CURPOS (AH = 02H) 


This function sets the row and column address of the cursor to the specified page and moves the cursor to 
that address. When the Multimode Video Display Adapter is in one of the graphics modes, a page number 
of 0 must be specified. 


On Entry: AH = F10 SET _CURPOS (02H) 


BH = Display page number 
DH = Row address of cursor. (0. . .24) 
DL = Column address of cursor. (0. . .79) 


On Exit: No values returned. 


Registers Altered: None 


F10 RD __CURPOS (AH = 03H) 


This function returns the current address and size of the cursor on the specified page. If the Multimode 
Video Display Adapter is in one of the graphics modes, a page number of 0 must be specified. Otherwise, 
the values returned for the cursor size in the graphics mode will be invalid. 


On Entry: AH 
BH 


F10 RD_CURPOS (03H) 
Display page number 


On Exit: CH = Starting scan line 


CL = Ending scan line 
DH = Row address of cursor. (0. . .24) 
DL = Column address of cursor. (0. . .79) 


Registers Altered: CX, Dx 


F10_RD__PENPOS (AH = 04H) 


This function returns the current state and position of the light pen if it is activated. The position 1s 
reported in both character row/column and graphic pixel formats. 


On Entry: AH = F10_RD PENPOS (04H) 
On Exit: AH = Light Pen state 
Data Definition: 


0 Not activated 
+ Activated 


BX = Horizontal pixel position of light pen 

CH = Vertical pixel position of light pen (200 line mode) 
DH = Row position of light pen 

DL = Column position of light pen 


Registers Altered: AH, BX, CH, DX 
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F10_SET_ PAGE (AH = 05H) 


This function-sets the active display page in the alphanumeric mode. Valid page numbers are 0 through 
7 for 80 x 25 modes, and O through 7 for 40:x.25 modes. This function is not valid for graphics modes. 


On Entry: AH 
AL. 


F10 SET PAGE (0SH) 
Page number (0 through 7} 


On Exit: No values returned. 


Registers Altered: AX 


Fi0 SCROLL__UP (AH = 06H) 


This function scrolls the contents of a window up a specified number of lines. The window is defined by 
the row and column addresses stored in the CX and DX registers. The number of lines to be scrolled is 
passed in register AL. If AL is set to 0, the function interprets this as a command to scroll all lines. 


On Entry: AH F10 SCROLL_UP (06H) 


AL = Number of lines to scroll (0 = scroll all) 

BH = Attribute to place in blanked lines 

CH = Row address of upper left corner of window (0. . .24) 

CL = Column address of upper left corner of window (0. . .79) 
DH = Row address of lower right corner of window (0. . .24) 

DL = Column address of lower right corner of window (0. . .79) 


On Exit: No values returned. 


Registers Altered: None 


F10_SCROLL_DN (AH = 07H) 


This function scrolls the contents of a window down a specified number of lines. The window is defined 
by the row and column addresses stored in the CX and DX registers. The number of lines to be scrolled is 
passed in register AL. If AL is set to O, the function interprets this as a command to scroll all lines. This 
function is only valid when the Multimode Video Display Adapter is in one of the alphanumeric modes. 


On Entry: AH = F10 SCROLL_DN (07H) 


AL = Number of lines to scroll (0 = scroll all) 

BH = Attribute to place in blanked lines 

CH = Row address of upper left corner of window (0. . .24) 

CL = Column address of upper left corner of window (0. . .79) 
DH = Row address of lower right corner of window (0. . .24) 

DL = Column address of lower right corner of window (0. . .79) 


On Exit: No values returned. 


Registers Altered: None 
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F10_ RD __CHARATR (AH = 08H) 


This function returns the character byte and attribute byte at the current cursor location. If the 
Multimode Video Display Adapter is in one of the alphanumeric modes, a page number must be specified. 
If the video display adapter is in one of the graphics modes, only the character is | returned, since 
characters do not have attribute bytes in the graphics modes. 


On Entry: AH 
BH 


F10 RD _CHARATR (08H) 
Page number (alphanumeric modes only) 


On Exit: AH 
AL 


Attribute byte (valid only in alphanumeric modes) 
Character 


Registers Altered: AX 


F10_WR __CHARATR (AH = 09H) 


This function writes character and attribute bytes at the current cursor location. If the Multimode Video 
Display Adapter is in one of the alphanumeric modes, a page number may be specified. If the Multimode 
Video Display Adapter is in one of the graphics modes, only the character is written. More than one 
character and attribute can be stored by placing the number of copies desired in CX. This function will 
wrap around both line and screen if too many characters are specified. Note that this function makes 
copies of a single character/attribute combination; it does not print a string. Refer to the Write String 
function for that operation. 


On Entry: AH = F10 WR_CHARATR (09H) 


AL = Character 

BH = Page number (alphanumeric modes only) 

BL = Attribute byte (valid only in alphanumeric modes) 
CX = Number of characters to write 


On Exit: No values returned. 


Registers Altered: None 


F10_ WR _CHARCUR (AH = OAH) 


This function writes a character to the current cursor location, retaining the existing attribute byte. The 
function 1s identical to the F10_|WR_CHARATR function, except that no attribute byte is written. 


On Entry: AH = F10 WR_CHARCUR (OAH) 


AL = Character . 
BH = Page number (alphanumeric modes only) 
CX = Number of characters to write 


On Exit: No values returned. 


Registers Altered: None 
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F10 SET _PALLE 


T (AH = OBH) 


This function allows setting the background color (if BH = 0) or the foreground color pallet (if BH = 1). 


On Entry: AH 
BH 


Data 


0 


F10 SET PALLET (OBH) 
Color Select ID 


Definition 


Set the background color (in medium resolution 
modes) or the foreground color (in high resolution 
modes) based on the low bits of BL (bits 0. . .3) 
to one of 16 colors. 


Select color pallet (for medium resolution modes) 
based on the least significant bit of BL. If 

bit 0 of BL = O then select the green, red, 

brown pallet. If bit 0 of BL = 1 then select the 
cyan, magenta, light gray pallet. 


BL = Color select value 


On Exit: No values returned 


Registers Altered: None 


F10_WR _ PIXEL (AH = OCH) 


This function writes a pixel on the screen. If the Multimode Video Display Adapter is in one of the "Four 
color" modes (320 x 200) the color of the pixel may be passed in register AL. Bits 0 and 1 of AL are 
interpreted as the color bits. If bit 7 of AL is set, bits 0 and | are "XORed" with the current pixel color 
bits, otherwise they replace the current pixel color bits. If the Multimode Video Display Adapter is in the 


"Two color" mode (640 x 


On Entry: AH 
AL 


200), the bit corresponding to the desired pixel is set. 


FIO WR PIXEL (OCH) 
Color 


In "Four color" mode (320x200): 


Bit Data 
7 1 

(8) 
0,1 


Definition 


Bits 0 and 1 XORed with 

current pixel. 

Bits 0 and 1 replace current pixel. 
Color bits. | 
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In “Two color" mode (640x200): 


Bit Data Definition 


7 1 Bit 0 XORed with current pixel. 
0 Bit 0 replaces current pixel. 
0 Color bit. 
CX = Horizontal pixel address 


DX = Vertical pixel address 
On Exit: No values returned. 


Registers Altered: AX 


F10_RD _ PIXEL (AH = ODH) 
This function returns the color code of the specified pixel. 
On Entry: AH 


CX 
Dx 


F10 RD PIXEL (ODH) 
Horizontal pixel address 
Vertical pixel address 


On Exit: AL = Color value of pixel 


Registers Altered: AX, CX, DX 


F10_WR __CHARTEL (AH = OEH) 


This function writes a character to the active page, then advances the cursor one location. At the end of 
a line, the cursor will wrap to the next line; at the end of the screen, the cursor will scroll. In the 
alphanumeric modes, this function maintains the current video display attributes. In the graphics modes, 
the foreground color is passed in register BL. The ASCII characters Line Feed (OAH), Carriage Return 
(ODH), Backspace (08H), Bell (07H), and Tab (09H) are interpreted by this function as ASCII commands 
and are executed as such. 


On Entry: AH 
AL 
BL 


F10 WR CHARTEL (OEH) 
Character 
Foreground color (in graphics modes only) 


On Exit: No values returned. 


Registers Altered: AX 
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F10_ GET _STMODE (AH = OFH) 


This function returns the current Multimode Video Display Adapter state. The mode, number of 
characters per line, and current display page are returned. 


On Entry: AH F10 GET STMODE (OFH) 


Number of characters per line 
Current mode 
Current display page 


On Exit: AH 
AL 
BH 


Registers Altered: AX, BH 


Write String (AH = 13H) 


This function writes a string of characters to the screen. This function consists of four separate 
subfunctions which control whether each character has its own attribute byte or not, and whether the 
cursor is moved or not. Each of the subfunctions is detailed in the following. The ASCII characters Line 
Feed (OAH), Carriage Return (ODH), Backspace (08H), Bell (07H), and Tab (09H) are interpreted by 
this function as ASCII commands and are executed as such. 


F10__WRS__00 (AX = 1300H) 


Write string attribute without moving cursor. 


On Entry: AX = F10_WRS_ 00 (1300H) 
BH = Display page number 
BL = String attribute byte 
CX = Length of string 
DH = Row address of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string. Format of string is: 


Char, Char, .. ., Char 
On Exit: No values returned. 


Registers Altered: None 
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F10 WRS_ 01 (AX = 1301H) 
Write string attribute and move cursor. 


On Entry: AX = F10 WRS_01 (1301H) 


BH = Display page number 
BL = String attribute byte 
CX = Length of string 
DH = Row address of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string. Format of string is: 


Char, Char, .. ., Char 
On Exit: No values returned. 


Registers Altered: None 


F10 WRS_ 02 (AX = 1302H) 
Write character attribute without moving cursor. 


On Entry: AX = F10_ WRS 02 (1302H) 


BH = Display page number 
CX = Length of string 
DH = Row address of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string. Format of string is: 


Char, Attr, Char, Attr, ..., Char, Attr 
On Exit: No values returned. 


Registers Altered: None 


F10_WRS_ 03 (AX = 1303H) 
Write character attribute and move cursor. 


On Entry: AX = F10_WRS_03 (1303H) 


BH = Display page number 
CX = Length of string 
DH = Row address of first character 
DL = Column address of first character 
ES:BP = Pointer to start of string. Format of string is: 


Char, Attr, Char, Attr, ..., Char, Attr 
On Exit: No values returned. 


Registers Altered: None 
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HP Extended Video Functions 


This set of functions support the features of the Multimode Video Display Adapter which are not covered 
using the standard video functions. This function consists of separate subfunctions which support the 
various extended capabilities of the Multimode Video Display Adapter (implemented through the 
EX-BIOS). Each of these subfunctions is defined in the following subsections. 


F10 INQUIRE (AX = 6FOOH) 


This subfunction determines whether or not the extended HP functions are available. If the extended 
video functions are available, the BX register will be set to 4850H (which is the ASCII characters "HP"). 


On Entry: AX = F10_ INQUIRE (6F OOH) 
BX = Any value except 4850H (’HP’) 
On Exit: BX = “HP” (4850H) 


Registers Altered: AX, BX 


F10_ GET INFO (AX = 6FO01H) 
This function returns information about the active display adapter. 
On Entry: AX = F10_GET_INFO (6FO1H) 


On Exit: AH 


Status register information 
Bit Data Definition 


Display Enabled. 

Light Pen Trigger Set. 
Light Pen Switch Made. 
Vertical Sync. 

Monitor Resolution 

0 350 or 400 line monitor 
1 200 line monitor 


AWN =O 
—_— = ot oe 


5 Display type 
0 Color 
1 Monochrome 
6-7 Diagnostic Bits 


AL = Card Identifier 
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Data Definition 


OOH Non HP card with ROM and possibly its own INT 10H driver. 
41H Multimode Video Display Adapter 

42H Reserved 

43H Reserved 

44H Reserved 

45H Industry Standard Monochrome Display Adapter 

46H Industry Standard Color Display Adapter 

51H Reserved 


CL = Current value of Extended Control register. This register 
is only valid when the Card Identifier is 41H. 


This description applies to data returned when a Multimode Video Display Adapter is in the system. 


Bit Data Definition 


0 Current screen resolution 
0 200 line 
1 400 line 

1 Underline enable. 


0 Blue bit of foreground attribute 
interpreted as color blue. 

1 Blue bit of foreground attribute 
interpreted as underline. 


2 Font Selected. 
0 PC-8 
1 HP ROMANS 

3 Memory disable. 


0 Memory enabled for CPU access. 
Memory disabled for CPU access. 
4 16/32K Memory select. 
0 Wrap second 16K of RAM into first 16K. 
Allow access to full 32K of memory. 
5 Page select. 

0 Select first 16K of memory. 

1 Select second 16K of memory. 
6-7 Unused 


ao 


net 


Registers Altered: AX, CL 
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F10 SET _INFO (AX = 6F02H) 


This function modifies the value of the Extended Control register port 3DDH on the Multimode Video 
Display Adapter. (Refer to the Vectra Accessories Technical Reference Manual - for either the Vectra ES 
or RS - for more information about this port.) 


On Entry: AX 
BL 


F10 SET_INFO (6FO2H) 
Byte of data to be written to 
the Extended Control Register. 


Bit Data Definition 


0 Current screen resolution 
0 200 line 
1 400 line 

1 Underline enable. 


0 Blue bit of foreground attribute 
interpreted as color blue. 

1 Blue bit of foreground attribute 
interpreted as underline. 


2 Font Selected. 
0 PC-8 
1 HP ROMANS 

3 Memory disable. 


0 Memory enabled for CPU access. 
1 Memory disabled for CPU access. 
4 16/32K Memory select. 
Wrap second 16K of RAM into first 16K. 
1 Allow access to full 32K of memory. 
5 Page select. 
Select first 16K of memory. 
1 Select second 16K of memory. 
6-7 Reserved 


On Exit: No values returned. 


Registers Altered: AX, BL 
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F10 MOD _ INFO (AX = 6FO03H) 


This function modifies individual bits in the Extension Control register (port 3DDH) of the Multimode. 
Video Display Adapter. A mask byte is passed in register BH, which allows individual bits to be modified 
without changing the state of other mode bits in the register. 


On Entry: AX = F10_ MOD_INFO (6F03H) ; 
; BH = Mask. Bits with a mask value of "1" are not modified; bits 
with a mask value of "0" are modified. 
BL = Bits to change. The bits indicated by the mask (BH) 
take the value of the BL register. 


Bit Data Definition 


0 Current screen resolution 
O 200 line 
1 400 line 

1 Underline enable. 


O Blue bit of foreground attribute 
interpreted as color blue. 

1 Blue bit of foreground attribute 
interpreted as underline. 


2 Font Selected. 
O PC-8 
1 HP ROMAN8 

3 Memory disable. 


QO Memory enabled for CPU access. 
1 Memory disabled for CPU access. 

4 16/32K Memory select. 
Q Wrap second 16K of RAM into first 16K. 
1 Allow access to full 32K of memory. 

5 Page select. 
O Select first 16K of memory. 
1 Select second 16K of memory. 

6-7 Reserved 


On Exit: No values returned. 
Registers Altered: AX 
Example: 

MOV AX,F10 MOD _INFO 
MOV BL,00000100B 


MOV BH,11111011B 
INT 10H 


EX-BIOS Function - Modify Ex-Reg (6F03H) 
Select Character Font: HP ROMAN8& 

Only Modify Character Font 

Call Video Interrupt 


we we we we 
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F10 GET __RES (AX = 6F04H) 


This function returns the current video mode and screen resolution. 


On Entry: AX = F10_GET_RES (6F04H) 


On Exit: AL = Current video mode (See Set Mode.) 


Data Definition 


OOH 
01H 
02H 
03H 
04H 
05H 
OGH 
07H 
08H 
OSH 
OAH 
OBH 
OCH 
ODH 
OEH 
OFH 


If in one of the graphics modes: 


BX 
CX 


Hou 


40 
40 
80 
80 
320 
320 
640 
80 
80 
80 
40 
40 
640 
640 
320 
320 


If in one of the text modes: 


BX 
CX 


xx xKxXxxXKKKXKX KK KKK XK XR 


25 Alphanumeric Black and White 
25 Alphanumeric Color | 
25 Alphanumeric Black and White 
25 Alphanumeric Color 

200 Graphics Color 

200 Graphics Black and White 
200 Graphics Black and White 

25 Only Valid for Monochrome Cards 
27 Alphanumeric Black and White 
27 Alphanumeric Color | 

27 Alphanumeric Black and White 
27 Alphanumeric Color 

400 2 Color 

400 Graphics Black and White 
400 Graphics Color 

400 Graphics Black and White 


Horizontal resolution in pixels 
Vertical resolution in pixels 


Number of characters per row 
Number of rows 


Registers Altered: AX, BX, CX 
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F10_XSET _ MODE (AX = 6FO5H) 


This function places the HP Multimode Video Display Adarter in one of sixteen possible modes of 
operation. Modes 0 through 7 are identical to the modes available with function F10_SET MODE of 
the video driver. Modes 8 through 15 are unique to the HP Vectra and the Multimode Video Display 
Adapter and may only be set using this function. 


Programmers must exercise caution when setting video modes with both F10_ SET MODE (0H) and 
F10_XSET_MODE (6F05H). Whenever F10_XSET MODE is used to select one of the "HP only" 
modes (8-15), F10__XSET_MODE (not F10_ SET MODE) must be used to return to one of the 
industry standard modes (0-7). This "pairing" of function calls is necessary because FIO_XSET MODE 
modifies an I/O port not normally affected by the industry standard modes. F10_ SET MODE does not 
deal with this I/O port. 


On Entry: AX = F10 XSET MODE (6F05H) 
BL = Video mode 


Data Definition 


OOH 40 x 25 Alphanumeric Black and White 
O1H 40 x 25 Alphanumeric Color , 
02H 80 x 25 Alphanumeric Black and White 
03H 80 x 25 Alphanumeric Color 

04H 320 x 200 Graphics Color 

OSH 320 x 200 Graphics Black and White 
O6H 640 x 200 Graphics Black and White 
O7H 80 x 25 Only Valid for Monochrome Cards 
O8H 80 x 27 Alphanumeric Black and White 
OSH 80 x 27 Alphanumeric Color 

OAH 40 x 27 Alphanumeric Black and White 
OBH 40 x 27 Alphanumeric Color 


OCH Reserved ’ 

ODH 640 x 400 Graphics Black and White 
OEH 320 x 400 Graphics Color 

OFH 320 x 400 Graphics Black and White 


On Exit: No values returned. 

Altered Registers: AX, BL 

Example: 

MOV AX,F10_ XSET MODE ; Call EX-BIOS function Set mode (6F05H) 


MOV BL,ODH ; Select 640 x 400 line mode 
INT INT VIDEO ; Call video interrupt (10H) 
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Input System and HP-HIL 





The Input System is a set of drivers which support the HP-HIL input devices. Up to seven HP-HIL input 
devices may be connected at one time. The Input System can support properly integrated non-HP-HIL 
devices as well. 


Overview 


The standard devices that connect to the system via the HP-HIL link are the mouse, touchscreen, and 
tablet. The interfaces for simple mouse, touchscreen, and tablet support are described in this Chapter. 


The architecture of the Input System is divided into two levels (see Figure 4-1). The application interface 
level allows the programmer to communicate with the HP-HIL devices with minimum overhead. The 
second level, the hardware interface level, allows programmers to manipulate the internals of the system. 
With this interface, support for additional devices can be added or the data path of existing ones 
re-directed. 


The first portion of this chapter provides an overview of the application interface level, a detailed 


description of the actual interfaces, and how to access them. The second portion of this chapter describes 
the hardware interface level. 


Application Interface Level 
Application programs interface with the Input System through a set of logical device drivers. The Input 


System has an application interface for the tablet, pointer (simple mouse), and touchscreen input devices. 
The Input System device drivers are shown in Figure 4-1. 
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Application 


Pointer 



























Touch Tablet 








Screen (Simple Mouse) Interface 
Interface Interface (V_LTABLET) 
(V_LTOUCH) (V_LPOINTER) 


Application Interface Level 





Hardware 
Interface 
Drivers 


Hardware Interface Level 


Physical Input Devices 


Figure 4-1. Input System Block Diagram 


The tablet, pointer, and touchscreen application program interface drivers are grouped together in Figure 
4-1 as they are all Graphic Input Device (GID) drivers. GID drivers accept relative graphic motion data, 
absolute graphics data, and button scancode data from the input devices. Data from these devices is 
represented in a consistent manner throughout the Input System, making programmatic access to different 
Graphic Input Devices a simple task (see the Application Event Driver Example later in this chapter). 


Overview 


The Input System supports three logical GID drivers; one for each of the standard GID data types. There 
is a GID driver for each of the touchscreen, pointer (simple mouse), and tablet devices called 
V_LTOUCH, V_LPOINTER, and V_LTABLET respectively. Each of these drivers has a fixed location 
in the HP_ VECTOR_ TABLE. They all share a common code module (i.e., they have the same CS:IP in 
the table), but have different data areas. 


The GID drivers perform clipping and scaling under certain conditions. Absolute devices like the 
touchscreen and tablet are always scaled but clipping is user selectable. Relative devices like the mouse 
can have both scaling and clipping selected by the user. 


The logical GID drivers perform two additional tasks. The first is graphics cursor movement (sprite 
tracking). This is performed by the EX-BIOS driver V_ STRACK, which 1s called by the logical GID 
driver if tracking is enabled. The second task is to provide interrupt service to the application. The 
application may install a routine to be called by the logical GID driver every time a GID event occurs, as 
opposed to the application calling the GID driver repeatedly (polling) to see if an event has occurred. 


The following text outlines the actions that occur for touchscreen input, from touching the screen to 
application data retrieval. 


1. The user touches the screen. This causes the physical device to generate input data and interrupt the 
hardware interface level. 
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2. The hardware interface level processes the interrupt and passes the data (ISR Event Record) to the 
logical touchscreen driver (V_LTOUCH). 


3. V_LTOUCH scales the event to fit the current dimensions of the screen. At this point two optional 
things may happen. First, the data may be clipped. Second, the user defined event driver will be 
called if it is installed and enabled. 


4. If the user event routine was not installed and enabled, then the application must call (poll) 
V_LTOUCH with the F_ SAMPLE function (see V_LTOUCH functions) to get the input data. 


There are two methods for applications to receive data from the Input System: polled mode and interrupt 
mode. In polled mode, the application must continually interrogate the logical GID driver using the 

F_ SAMPLE function to determine if any input has occurred. In interrupt mode, the application must 
first install an ISR event handling routine (application event driver) using SF CREATE EVENT to 
handle interrupt calls from the logical GID driver. After installation, the application informs the logical 
GID driver that it is ready to receive interrupts by calling the SF_EVENT_ON subfunction. After event 
interrupts have been enabled, the application will receive an interrupt every time the logical GID driver 
receives data from the hardware interface level. 


Data Structures 
The application interface level uses two major data structures: the Logical Describe Record and the 


Logical ISR Event Record(s). These data structures help keep track of the numerous events occurring in 
the Input System. 


Logical Describe Record 

The Logical Describe Record is used by the logical GID drivers to keep track of the current state of their 
respective devices. Each of the logical GID drivers has a Logical Describe Record associated with it, which 
is located directly after the driver header starting with memory address DS:0010H. Table 4-1 lists the 
field types and offsets of the Logical GID Driver Describe Record. An explanation of the Logical GID 
Driver Describe Record follows the table. 


Table 4-1. Logical GID Driver Describe Record 


ee 


Driver Header Driver Header (see Chapter 2) 
LD_SOURCE Device GID type 
LD_HPHIL_ID Physical device ID 
LD_DEVICE_STATE Status bits for the logical device 


LD_INDEX Physical device vector number 


LD_MAX_ AXIS Maximum number of axes 
reported 
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Table 4-1. Logical GID Driver Describe Record (Cont.) 


ee 


LD_CLASS Device class 

LD PROMPTS Number of button/prompts 17H 
LD_ PARAGRAPHS Size of this record in paragraphs 18H 
LD_RESERVED Reserved 19H-1BH 
LD_TRANSITION Button transitions ICH 
LD_STATE | Current state of the buttons 1DH 
LD_RESOLUTION Logical device resolution LEH 
LD_SIZE_X Maximum x-axis count 20H 
LD_SIZE_Y Maximum y-axis count 22H 


LD_ABS xX X position data for absolute 24H 
devices 


LD_ABS_Y Y position data for absolute 26H 
devices 


LD_REL_ xX X delta for relative devices 28H 


LD_REL_Y Y delta for relative devices 2AH 
LD_ACCUM_X X-axis scaling accumulator 2CH 
LD_ACCUM_Y Y-axis scaling accumulator 2EH 
LD_SIZE_Z Maximum z-axis count 30H 


LD_ABS_ Z Z position data for absolute 32H 
devices 


LD_REL_ Z Z delta for relative devices 34H 


LD_ACCUM_Z Z-axis scaling accumulator 36H 
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Logical Describe Record Definitions 


This field is divided into nibbles. Bits 7-4 contain the graphics input 
device type. This field is loaded with the low order nibble of the ap- 
propriate logical GID data type (Table 4-5). Bits 3-0 are reserved. 


LD_ SOURCE 


LD_HPHIL_ID ID byte of the physical device which last reported data. Table 4-2 lists 


the HP-HIL device ID bytes. 


Table 4-2. HP-HIL Device ID Bytes 






































































Other OOH-2BH Reserved 
2CH-2FH Tone Generator 
30H-3FH Reserved 

Character Entry 40H-4FH Reserved 
§0H-5BH Reserved 
§$CH-SFH Bar code Reader 

Relative Positioners 60H-67H Reserved 
68H-6BH Mouse 
6CH-6FH Trackball 
70H-7FH Reserved 

Absolute Positioners 80H-87H Reserved 
88H-8BH Touchpad 
8CH-8FH Touchscreen 
90H-97H Graphics Tablet 
98H-9FH Reserved 





QOAOH-OFFH Reserved 


LD_DEVICE_STATE 


Status bits for the logical device: 


Bit Definition 
OFH-O5H Reserved. 
04H Event enabled when set. 
03H Tracking enabled when set. 
02H Clipping enabled when set. 
O1H Button error occurred when set. 
OOH Interrupt in progress when set. 
LD_ INDEX This contains :he vector address divided by 6 of the last physical device 


that reported data. 
LD_MAX AXIS Maximum nuriber of axes supported by the device. Valid range is 0-2. 
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LD_ CLASS 
LD _ PROMPTS 
LD_ PARAGRAPHS 


LD_ TRANSITION 


LD_ STATE 


LD_RESOLUTION 


LD_SIZE_X 
LD_SIZE_Y 


LD_ABS X 


LD_ABS_Y 


LD_REL_ X 
LD_REL_Y 


LD_ACCUM_X 


LD _ACCUM_Y 


LD SIZE Z 
LD_ABS Z 


LD_ REL Z 


LD_ACCUM_Z 


Device class. Bits 7-4 contain the current class. Bits 3-O contain the 
default class. See Appendix G for more information on device classes. 


Number of buttons and prompts supported by the device. Bits 7-4 con- 
tain the number of prompts. Bits 3-0 contain the number of buttons. 


Size of this record in paragraphs: 0 means 3 paragraphs, | means 4 
paragraphs. ; 


Transitions reported per button, i.e., a set bit indicates that the cor- 
responding button was either pushed or released. Bit 7 corresponds to 
button 7 etc. 

Current state of the buttons. | is down, 0 is up. Bit 7 corresponds to 
button 7 etc. If LD_STATE is XOR’ed with LD_ TRANSITION the 
result is the previous button state. 


This is the resolution of the logical device. For logical devices this is 
typically one. 


Maximum count (in units of resolution) for the x-axis. 
Maximum count (in units of resolution) for the y-axis. 


X position data for devices which report absolute coordinates (absolute 
devices). 


Y position data for devices which report absolute coordinates. 


Latest change in x position for devices which return coordinates relative 
to the previous position (relative devices). 


Latest change in y position for devices which return coordinates relative 
to the previous position. 


Accumulator used to sum partial movements when scaling from the 
physical device space to the logical device space. The value stored here 
represents a fraction of one logical unit for the x-axis. 


Accumulator used to sum partial movements when scaling from the 
physical device space to the logical device space. The value stored here 
represents a fraction of one logical unit for the y-axis. 

Maximum count (in units of resolution) for the z-axis. 


Z position data for devices which report absolute coordinates. 


Latest change in z position for devices which return coordinates relative 
to the previous position. 


Accumulator used to sum partial movements when scaling from the 
physical device space to the logical device space. The value stored here 
represents a fraction of one logical unit for the z-axis. 
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Logical ISR Event Records 
A Logical ISR Event Record is not a data structure in the truest sense, but is a set of register definitions 
for inter-driver communication of input events. These definitions apply not only to Input System drivers 


but to application event drivers as well. The following define the Logical ISR Event Records. 


GID Button ISR Event Record 


AH = F_ISR (OOH) 
DL = Physical device driver’s vector address / 6 
BX = Button information. 
Bit Value Definition 
OFH-O8H - Reserved 
O7H 1 Button up 
0 Button down 
O6H-00H - Button number (0-7) 
DH = Data Type 
ES:0 = Pointer to Physical device driver 


header and Physical Describe Record. 


GID Motion ISR Event Record 


AH = F_ISR (OOH) 
DL = Physical device driver’s vector address / 6 
BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 
SI = Z axis motion in raw data form. 
DH = Data Type 
ES:0 = Pointer to physical device driver 


header and Physical Describe Record. 


The button number in the Button information field (BX) denotes which button on the device is reporting 
data. Of special interest is button seven (proximity indicator) which is currently used by absolute devices 
to indicate that the device measurement field is active. For example, someone is touching the touchscreen, 
or the stylus is in contact with the tablet surface. 


The Data Type field (DH) contains a code representing the current type of logical GID data stored in the 
event record. For button events this value will be T_KC BUTTON. For logical GID motion events, 
permissible types are: T_TS, T_POINTER and T_ TABLET, which correspond to data originating from 
V__LTOUCH, V_LPOINTER, and V_LTABLET respectively. For a complete list of logical GID event 
data types see Table 4-3. 
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Table 4-3. Logical GID Event Data Types 


T_KC BUTTON Button data 


T_TS Specially formed data (80x25--default) 
generated by V_ LTOUCH 


T_TABLET Specially formed data (640x200 range--default) 
generated by V_ LTABLET 


T_POINTER Specially formed data (640x200 range--default) 
generated by V_LPOINTER 





Application Event Drivers 


As previously mentioned, applications may install a routine to handle interrupts from the logical GID 
drivers. Three predefined vectors in the HP_VECTOR_ TABLE are initialized to the null driver 
(V_PNULL). The three vectors are V_EVENT_TOUCH, V_EVENT_ POINTER, and 

V_EVENT_ TABLET which are called by the logical GID drivers V_LTOUCH, V_LPOINTER, and 
V_LTABLET respectively when event interrupts are enabled by a call to SF_EVENT_ ON. A call to 
SF _CREATE_EVENT sets the corresponding event vector to point to the user application event 


The application event driver is required to support only one function, F_ISR. The driver should return 
RS_ UNSUPPORTED for all unimplemented functions. 


Logica! GID Drivers 
The drivers V_ LTOUCH, V_LPOINTER, and V_LTABLET represent the application interface to the 


Input System. These drivers provide functions to poll for data, enable/disable application event interrupts, 
enable/disable tracking, and enable/disable clipping and/or scaling. 


V_LTOUCH Driver (BP = OOCG6H) 


This section contains a detailed description of the touchscreen driver. Table 4-4 is a summary of the 
touchscreen driver function code. 
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Table 4-4. Touchscreen Driver Function Code Summary 


Function Function 
Value Equate Definition 


V_LTOUCH Application interface to Touchscreen 














F_ISR Logical Interrupt 









F_SYSTEM System functions 





Initialize the driver data area 






SF_INIT 






SF_ START Start driver 





SF REPORT STATE Report state of device 





SF_VERSION _ DESC 





Report driver version number 








SF_DEF_ATTR Set default logical scaling attributes 








SF_GET_ATTR Get scaling attributes 








Set scaling attributes 






SF_SET_ATTR. 






F_IO_ CONTROL I/O Control functions 





SF_ LOCK Unsupported 








SF_ UNLOCK Unsupported 







SF_TRACK ON Turn cursor track on 






SF_TRACK_ OFF Turn cursor track off 








SF_CREATE _EVENT Establish a new routine to be called on logical device 


events 








SF_EVENT_ON Enable event call to parent driver 









SF_EVENT_OFF Disable event call to parent driver 









SF_CLIPPING _ON Enable logical device clipping 






SF_CLIPPING _ OFF 






Disable logical device clipping 





F_SAMPLE Report absolute position of GID 
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Touchscreen Driver Functions Definitions 


F ISR (AH = OOH) 


This function receives an ISR Event record from one of the physical GID drivers. The calling driver has 
handled the physical interrupt and updated the Physical Describe Record to reflect the event. This 
function translates the physical event into the logical coordinate system and calls its parent, 
V_EVENT_TOUCH, (if EVENT is enabled). In addition, this function passes the event to V_STRACK 
so that the sprite can be updated (if TRACK is enabled). This function is a response to a logical hardware 
interrupt and not user callable. 


On Entry: AH = F_ISR (00H) 
DH = Data Type 
DL = Physical device driver’s vector index. 
ES:0 = Pointer to Physical device driver header and Physical 
Describe Record. 
BP = V_LTOUCH (OOC6H ) 


For Button Event: 
BX = Button information. 


Bit Value Definition 
OFH-0O8H - Reserved 
07H 1 Button up 

0 Button down 


O6H-OOH Button number (0-7) 
For Motion Event: 

BX X axis motion in raw data form. 
CX Y axis motion in raw data form. 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF_CREATE_EVENT, SF_EVENT ON, SF_TRACK_ON 


SF_INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 fora complete discussion of the 
protocol used in data space allocation. 


On Entry: AH = F SYSTEM (02H) 


AL = SF_INIT (00H) 
BX = "Last used DS" in HP Data Area 
BP = V_LTOUCH (OOC6H) 
On Exit: AH = Return Status Code 
BX = New “last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 
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SF_ START (AX = 0202H) 


This subfunction starts the logical touchscreen driver. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_START (02H) 
BP = V_LTOUCH (OOC6H ) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_ REPORT _ STATE (AX = 0204H) 
This subfunction returns the LD_ DEVICE_STATE field from the Logical Describe Record. 


On Entry: AH F SYSTEM (02H) 


AL = SF_REPORT STATE (04H) 
BP = V_LTOUCH (00C6H) 
On Exit: AH = Return Status Code 


DX = LD DEVICE STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF__VERSION _ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_LTOUCH (00C6H) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
SF_ DEF __ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical touchscreen driver to their default values. The default 
attributes for the touch screen driver are: LD_SIZE_X = 79 and LD_SIZE_Y = 24. 
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On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF DEF _ATTR (08H) 
v_LTOUCH (O0C6H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_GET__ATTR (AX = 020AH) 
This subfunction returns the current scaling attributes, LD_SIZE_X and LD_SIZE_Y. 


On Entry: AH F_SYSTEM (02H) 


AL = SF _GET_ATTR (OAH) 
BP = V_LTOUCH (O0C6H ) 
On Exit: AH Return Status Code 


BX 
CX 


LD SIZE_X (logical size along X axis) 
LD | SIZE ~Y¥ (logical size along Y axis) 


Registers Altered: AX, BX, CX, BP, DS 


SF__SET__ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD_SIZE__X, and LD_SIZE__Y, in the Logical Describe 
Record. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF _SET_ATTR (OCH) 
BX = LD SIZE _X (logical size along X axis) 
CX = LD | . SIZE ¥ (logical size along Y axis) 
BP = V_ LToucH (OOC6H ) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__TRACK__ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V_STRACK will be called 
to update the graphics cursor (sprite) position. 


F_I0 CONTROL (04H) 
SF_TRACK_ON (04H) 
V_LTOUCH (00C6H) 


On Entry: AH 
AL 
BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF TRACK _ OFF (AX = 0406H) 
This subfunction turns tracking off. 
On Entry: AH 


AL 
BP 


F_I0 CONTROL (04H) 
SF_TRACK OFF (06H) 
V_LTOUCH (00C6H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CREATE_ EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS of the 
routine are passed to this subfunction. These values are exchanged with the vector entry of the 
V_EVENT_ TOUCH driver in the HP_VECTOR_TABLE, V_EVENT__TOUCH being the parent of the 
logical touchscreen driver. The IP, CS, and DS of the previous routine are returned to the caller. Note _ 
that this subfunction does not enable the event call to the parent routine; this must be done explicitly 
using SF_-EVENT_ ON. 


The ISR event records passed to the V_ EVENT TOUCH driver will have one of the following two 
formats, depending on the Data Type stored in DL. 


V_EVENT TOUCH Button ISR Event Record: 


AH = F_ISR (OOH) 
DL = Physical device drivers vector address / 6 
BX = Button information. 
Bit Value Definition 
OF H-O8H - Reserved 
O7H 1 Button up 
O6GH-OOH - Button number (0-7) 
DH = Data Type 
ES:0 = Pointer to V_LTOUCH device driver . 


header and Logical Describe Record. 


V_EVENT TOUCH Motion ISR Event Record: 


AH = F_ISR (OOH) 
DL = Physical device driver’s vector address / 6 
BX = A number between 0 and LD SIZE X 
CX = A number between 0 e1d LD SIZE Y 
DH = Data Type 
ES:0 = Pointer to V_LTOUCH tevice driver 


header and Logical G2scribe Record. 
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On Entry: AH F_IO CONTROL (04H) 


AL = SF _CREATE EVENT (08H) 

BP = V_LTOUCH (00C6H) 

DX = DS of new V_EVENT TOUCH routine 

SI = IP of new V_ _EVENT _ TOUCH routine 

ES = CS of new v_ EVENT TOUCH routine 

On Exit: AH = Return Status Code 

DX = DS of previous V_EVENT TOUCH routine 
SI = IP of previous v_ EVENT TOUCH routine 
ES = CS of previous V_EVENT TOUCH routine 


Registers Altered: AX, DX, SI, BP, ES, DS 
Related Functions: SF_EVENT ON 


The following example shows how to use the SF_CREATE EVENT function. The routine EVENT will 
be the event procedure that is called when events are enabled. 


EVENT PROC FAR 
CMP AH,F_ISR ;only support function F_ISR 
JE PROCESS EVENT 
MOV AH, RS_UNSUPPORTED 
IRET 

PROCESS EVENT: 
‘ code to process data 

(see touchscreen 

event record) 

return successful completion 


we we we we 


MOV AH, RS SUCCESSFUL 
IRET 
EVENT ENDP 


MOV AH, F_IO CONTROL 
MOV AL, SF_CREATE_EVENT 
MOV BP, V_LTOUCH 


MOV DX, DS ; want to use the current data segment for event DS 
PUSH CS 

POP ES ; current CS also segment of event routine 

LEA SI,CS:EVENT ; get the IP of the event routine 

PUSH DS ; save current DS 

CALL SYSCALL ; call extended BIOS driver 

POP DS 


SF EVENT ON (AX = 040AH) 
This subfunction enables the event (parent) call to the touchscreen event routine (V_- EVENT_ TOUCH). 


The link to the touchscreen event routine must have already been established using 
SF_CREATE_ EVENT. 
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F_I0 CONTROL (04H) 
SF_EVENT_ON (OAH) 
V_LTOUCH (OOC6H) 


On Entry: AH 
AL 
BP 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 
Related Functions: SF CREATE EVENT, 
SF_EVENT OFF 
SF__EVENT__OFF (AX = 040CH) 


This subfunction disables the call to the touchscreen event routine. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_EVENT_OFF (OCH) 
BP = V_LTOUCH (00C6H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF CLIPPING _ ON (AX = 040EH) 


This subfunction enables logical device clipping. Physical device motion will be scaled to logical space and 
will be clipped to avoid overflow or underflow. Clipping is activated for both absolute and relative 
motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make sure 
that the new position always falls within the logical space. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_CLIPPING ON (OEH) 
BP = V_LTOUCH (00C6H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF CLIPPING OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical space, but 
overfiow or underflow may occur. 


On Entry: AH 
AL 
BP 


F IO CONTROL (04H) 
SF_CLIPPING OFF (10K° 
V_LTOUCH (O0CG6H) 


Hor oe 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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F SAMPLE (AH = O6H) 


This function allows an application to poll the touchscreen device. This function reports the current 
absolute position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F_SAMPLE (06H) 
BP = V_LTOUCH (OOC6H) 


On Exit: AH = Return Status Code 
BX = Current logical position along X axis 
CX = Current logical position along Y axis 
DL = LD TRANSITION field of Logical Describe Record 
DH = LD STATE field of Logical Describe Record 
ES:0 = Pointer to logical device header and Describe Record 


Registers Altered: AX, BX, CX, DX, BP, DS, ES 
The following is an example of how to call the F_ SAMPLE function. 


load function code 
load vector address 


MOV AH, F_SAMPLE 
MOV BP, V_LTOUCH 


we we we wt we 


PUSH DS save the current DS 
CALL SYSCALL call extended BIOS driver 
POP DS restore DS 


V__LPOINTER Driver (BP = 0OCOH) 


This section contains a detailed description of the pointer driver. Table 4-5 summarizes the functions 
supported by the pointer driver. 


Table 4-5. Pointer Driver Function Code Summary 


Function Vector Func, 
Equate Address Value 


V_LPOINTER Application interface to 
Pointer / Mouse 

F_ISR Logical Interrupt 

‘-F_SYSTEM System functions 

SF_INIT Initialize the driver data area 

SF_START Start driver 

SF REPORT _ STATE Report state of device 

SF_ VERSION _ DESC Report driver version number 

SF_ DEF _ATTR Set default logical scaling 





attributes 
SF _GET _ATTR Get scaling attributes 
SF_SET ATTR Set scaling attributes 
F IO CONTROL I/O Control Functions 
SF_ LOCK Unsupported 
SF_ UNLOCK Unsupported 


4-16 Input System and HP-HIL 





Table 4-5. Pointer Driver Function Code Summary (Cont.) 


Function Vector 
Equate Definition Address 


SF_TRACK ON Turn cursor track on 
SF_TRACK _ OFF Turn cursor track off 

SF CREATE EVENT Establish a new routine to be 
called on logical device events 
Enable event call to parent 
driver 

Disable event call to parent 
driver 

Enable logical device clipping 
Disable logical device clipping 
Report absolute position of GID 


















SF_EVENT _ON 





SF_EVENT _ OFF 












SF CLIPPING _ON 
SF CLIPPING _ OFF 
F_ SAMPLE 


Pointer Driver Function Definitions 


F__ISR (AH = 00H) 


This function receives an ISR Event record from one of the physical GID drivers. The calling driver has 
handled the physical interrupt and updated the Physical Describe Record to reflect the event. This 
function translates the physical event into the logical coordinate system and calls its parent, 
V_EVENT_ POINTER, (if EVENT is enabled). In addition, this function passes the event to 
V_STRACK so that the sprite can be updated (if TRACK is enabled). This function is a response to a 
logical hardware interrupt and not user callable. 


On Entry: AH = F_ISR (00H) 
DH = Data Type 
DL = Physical device drivers vector index. 
ES:0 = Pointer to physical device driver 
header and Physical Describe Record. 
BP = V_LPOINTER (00COH) 


For Button Event: 
BX = Button information. 


Bit Value Definition 


OF H-O8H - Reserved 
O7H 1 Button up 
0 Button down 


O6H-OOH Button number (0-7) 


For Motion Event: 


BX = X axis motion in raw data form. 
CX = Y-axis motion in raw data form. 
SI = Z axis motion in raw data form. | 
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On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF _CREATE_EVENT, SF_EVENT_ON, SF_TRACK_ON 


SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol used in data space allocation. 


On Entry: AH 
AL 
BX 
BP 


F_ SYSTEM (02H) 

SF_INIT (00H) 

“Last used DS" in HP Data Area 
V_LPOINTER (OOCOH ) 


On Exit: AH 
BX 


Return Status Code 
New "last used DS” in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF START (AX = 0202H) 
This subfunction starts the logical pointer driver. 
On Entry: AH 


AL 
BP 


F_ SYSTEM (02H) 
SF_START (02H) 
V_LPOINTER (OOCOH ) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF REPORT __ STATE (AX = 0204H) 
This subfunction returns the LD_DEVICE_ STATE field from the Logical Describe Record. 


On Entry: AH F SYSTEM (02H) 


AL = SF_REPORT_STATE (04H) 
BP = V_LPOINTER (OOCOH ) 
On Exit: AH = Return Status Code 
DX = LD_DEVICE_STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF VERSION __ DESC (AX = 0206H) 
This subfunction returns the release date code and a double word pointer to the current version number. 


The date code consists of two BCD coded bytes containing tne year and week of release. ‘ine BL register 
contains the number of years since 1960 and the BH registes contains the week of the year. 
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On Entry: AH = F_SYSTEM (02H) 


AL = SF_VERSION DESC (06H) 
BP = V_LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF DEF _ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical pointer driver to their default values. The default 
attributes for the pointer driver are: LD SIZE X = 639, LD SIZE _Y = 199 and LD_SIZE_ Z = 100. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_DEF_ATTR (08H) 
V_LPOINTER (00COH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__GET__ATTR (AX = 020AH) 


This subfunction returns the current scaling attributes, LD _ SIZE _X, LD_SIZE_Y and LD_SIZE_ Z. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_GET_ATTR (OAH) 
BP = V_LPOINTER (OOCOH) 
On Exit: AH = Return Status Code 
BX = LD SIZE X (logical size along X axis) 
CX = LD SIZE Y (logical size along Y axis) 
SI = LD SIZE _Z (logical size along Z axis) 


Registers Altered: AX, BX, CX, BP, DS 
SF SET  ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD_SIZE_X, LD_SIZE_Y and LD_SIZE__Z in the Logical 
Describe Record. 
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On Entry: AH = F SYSTEM (02H) 


AL = SF_SET_ATTR (OCH) 
BX = LD SIZE X (logical size along X axis) 
CX = LD SIZE_Y (logical size along Y axis) 
SI = LD SIZE _Z (logical size along Z axis) 
BP = V_LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__TRACK__ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V_ STRACK will be called 
to update the graphics cursor (sprite) position. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_TRACK_ON (04H) 
BP = V_LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__TRACK__OFF (AX = 0406H) 


This subfunction turns tracking off. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_TRACK_OFF (06H) 
BP = V_LPOINTER (00COH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF CREATE _EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS of the 
routine are passed to this subfunction. These values are exchanged with the vector entry of the 
V_EVENT_ POINTER driver in the HP_VECTOR_TABLE, V_EVENT_ POINTER being the parent of 
the logical pointer driver. The IP, CS, and DS of the previous routine are returned to the caller. Note 
that this subfunction does not enable the event call to the parent routine; this must be done explicitly 
using SF_ EVENT_ON. 


The ISR event records passed to the V_ EVENT POINTER driver will have one of the following two 
formats depending on the Data Type stored in DL. 
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V_EVENT POINTER Button ISR Event Record: 


AH 
DL 
BX 


Bit 


OFH- 
OTH 


06H - 


DH 
ES:0 


F_ISR (00H) | 
Physical device driver’s vector address / 6 
Button information. 


Value Definition 


O8H = Reserved 
1 Button up 
0 Button down 
OOH - Button number (0-7) 
Data Type 


Pointer to V_LPOINTER device driver 
header and Logical Describe Record. 


V__EVENT _ POINTER Motion ISR Event Record: 


AH 
DL 
BX 


CX 


DH 
ES:0 


On Entry: AH 
AL 
BP 
DX 
SI 
ES 


thou nw # Wok 


On Exit: AH 
DX 
SI 
ES 


F_ISR (00H) 

Physical device driver’s vector address / 6 
Relative movement in the X direction 

(Positive number indicates movement to the right) 
Relative movement in the Y direction 

(Positive number indicates movement down) 

Data Type 

Pointer to V_LPOINTER device driver header and 
Logical Describe Record. 


F_IO CONTROL (04H) 
SF_CREATE_EVENT (08H) 

V_LPOINTER (OOCOH) 

DS of new V_ EVENT POINTER routine 
IP of new V_EVENT POINTER routine 
CS of new V_EVENT POINTER routine 


Return Status Code 

DS of previous V_EVENT POINTER routine 
IP of previous V_EVENT POINTER routine 
CS of previous V_EVENT POINTER routine 


Registers Altered: AX, DX, SI, BP, ES, DS 


Related Functions: SF_EVENT ON 


This example shows how to use the SF_CREATE EVENT function. The routine EVENT will be the 
event procedure that is called when events are enabled. 
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EVENT PROC FAR 
CMP AH, F_ISR 3; only support function F_ISR 
JE PROCESS EVENT . 
MOV AH, RS_UNSUPPORTED 
IRET 
PROCESS EVENT: 
; 3; code to process data (see 
3; pointer event record) | 


MOV AH, RS SUCCESSFUL ; return successful completion 
IRET 
EVENT ENDP 


MOV AH, F_IO CONTROL 
MOV AL, SF_CREATE_EVENT 
MOV BP, V_LPOINTER 


MOV DX, DS ; want to use the current data segment for event DS 
PUSH CS _ 
POP ES ; current CS is also segment of event routine 


LEA SI, CS: EVENT get the IP of the event routine 


we we we 


PUSH DS save current DS 
CALL SYSCALL call extended BIOS driver 
POP ODS . 


SF__EVENT_ON (AX = 040AH) 


This subfunction enables the event (parent) call to the pointer event routine (V_ EVENT _POINTER). 
The link to the pointer event routine must have already been established using SF_CREATE_EVENT. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_EVENT_ON (OAH) 
BP = V_LPOINTER (00COH) 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF CREATE EVENT, SF EVENT OFF 


SF__EVENT__OFF (AX = 040CH) 
This subfunction disables the call to the pointer event routine. 
On Entry: AH 


AL 
BP 


tt 


F_ IO CONTROL (04H) 
SF_EVENT OFF (OCH) 
V_LPOINTER (00COH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF CLIPPING _ON (AX = 040EH) 


This subfunction enables logical device clipping. Physical device motion will be scaled to logical space and 
will be clipped to avoid overflow or underflow. Clipping is activated for both absolute and relative 
motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make sure 
that the new position always falls within the logical space. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_CLIPPING ON (OEH) 
BP = V_LPOINTER (OOCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF CLIPPING _ OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical space, but 
overflow or underflow may occur. . 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_CLIPPING OFF (10H) 
BP = V_LPOINTER (OCOH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F SAMPLE (AH = O6H) 


This function allows an application to poll the pointer device. This function reports the current absolute 
position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F SAMPLE (06H) 


BP = V_LPOINTER (O0COH) 

On Exit: AH = Return Status Code 

BX = Current logical position along X axis 

CX = Current logical position along Y axis 

SI = Current logical position along Z axis 

DL = LD_TRANSITION field of Logical Describe Record 

DH = LD STATE field of Logical Describe Record 

ES:0 = Pointer to logical device header and Describe Record 


Registers Altered: AX, BX, CX, DX, 3P, DS, ES 


Input System and HP-HIL 4-23 


load function code 
load vector address 


MOV AH, F_SAMPLE 
MOV BP, V_LPOINTER 


we we we we we 


PUSH DS save the current DS 
CALL SYSCALL call extended BIOS driver 
POP DS restore DS 


V__LTABLET Driver (BP = OOBAH) 


This section contains a detailed description of the tablet driver. See Table 4-6 for a summary of 
functions supported by the tablet driver. 


Table 4-6. Tablet Driver Function Code Summary 


Vector Function Function . 
Address Value Equate Definition 


V_LTABLET Application interface 
to Tablet 


F_ISR Logical Interrupt 


F_SYSTEM System functions 


SF_ INIT Initialize the driver 
data area 


SF_ START Start driver 


SF_REPORT Report state of device 
_ STATE | 


SF_ VERSION _ DESC Report driver version 
number 


SF_DEF _ATTR Set default logical 
scaling attributes 


SF_GET _ATTR Get scaling attributes 
SF_SET _ATTR Set scaling attributes 
F_1I0 _CONTROL I/O Control Functions 
F SF LOCK Unsupported 


F SF UNLOCK Unsupported 
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Table 4-6. Tablet Driver Function Code Summary (Cont.) 


Vector Function Function 
Address Value Equate Definition 


OOBAH 04/04 F_ SF _TRACK _ON | Turn cursor track on 








OOBAH 04/06 F_SF TRACK Turn cursor track off 


_OFF 






















Establish a new 
routine to be called on 
logical device events 


OOBAH 04/08 F_SF CREATE 


__EVENT 
















Enable event call to 
parent driver 





F_SF EVENT _ON 









F_SF _EVENT 
_OFF 


Disable event call to 
parent driver 














F SF CLIPPING 
_ON 


Enable logical device 
clipping 
















F_SF _ CLIPPING 
_OFF 


Disable logical device 
clipping 








Report absolute posi- 
tion of GID 


F_SAMPLE 





Tablet Driver Functions Definition 


F__ISR (AH = OOH) 


This function receives an ISR Event record from one of the physical GID drivers. The calling driver has 
handled the physical interrupt and updated the Physical Describe Record to reflect the event. This 
function translates the physical event into the logical coordinate system and calls its parent, 
V_EVENT_TABLET, (if EVENT is enabled). In addition, this function passes the event to V_ STRACK 
so that the sprite can be updated (if TRACK is enabled). This function is a response to a logical hardware 
interrupt and not user callable. 


On Entry: AH = F_ISR (00H) 
DH = Data Type 
DL = Physical device driver’s vector index. 
ES:0 = Pointer to physical device driver header 
and Physical Describe Record. 
BP = V_LTABLET (OOBAH) 


For Button Event: 
BX = Button information. 
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Bit Value Definition 


OFH-O8H Reserved 
1 Button up 
0 Button down 
O6H-OOH Button number (0-7) 


For Motion Event: 


BX = X axis motion in raw data form. 
CX = Y axis motion in raw data form. 
SI = Z axis motion in raw data form. 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF_CREATE_EVENT, SF_EVENT_ ON, SF_TRACK_ON 


SF__ INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol used in data space allocation. 


On Entry: AH = F_SYSTEM (02H) 


AL = SF_INIT (00H) 
BX = "Last used DS" in HP Data Area 
BP = 


V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 
BX = New “last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF START (AX = 0202H) 
This subfunction starts the logical tablet driver. 
F SYSTEM (02H) 


SF_START (02H) 
V_LTABLET (OOBAH) 


On Entry: AH 
AL 
BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF REPORT _ STATE (AX = 0204H) 


This subfunction returns the LD_ DEVICE_ STATE field from the Logical Describe Record. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_REPORT STATE (04H) 
BP = V_LTABLET (OOBAH ) 

On Exit: AH Return Status Code 


DX LD DEVICE_STATE from Logical Describe Record 


Registers Altered: AX, DX, BP, DS 


SF VERSION _ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. . 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_LTABLET (0OBAH) 


On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF_DEF__ATTR (AX = 0208H) 


This subfunction sets the attributes of the logical tablet driver to their default values. The default 
attributes for the tablet driver are: LD_ SIZE _X = 639, LD-_SIZE_Y = 199 and LD_SIZE__Z = 100. 


On Entry: AH 
AL 
BP 


F_ SYSTEM (02H) 
SF_DEF_ATTR (08H) 
V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__GET__ATTR (AX = 020AH) 


This subfunction returns the current scaling attributes, LD_SIZE_X, LD SIZE _Y and LD_SIZE_Z. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_GET_ATTR (OAH) 
BP = V_LTABLET (OOBAH) 
On Exit: AH = Return Status Code 
BX = LD SIZE X (logical size along X axis) 
CX = LD SIZE_ “Y (logical size along Y axis) 
SI = LD SIZE Z (logical size along Z axis) 


Registers Altered: AX, BX, CX, BP, DS 


SF SET_ATTR (AX = 020CH) 


This subfunction sets the scaling attributes, LD_SIZE_X, LD_SIZE_ Y and LD_SIZE_Z in the Logical 
Describe Record. 


On Entry: AH = F_SYSTEM (02H) 


AL = SF _SET_ATTR (OCH) 
BX = LD SIZE _X (logical size along X axis) 
CX = LD_ SIZE S (logical size along Y axis) 
SI = LD. SIZE ee: (logical size along Z axis) 
BP = V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF TRACK __ON (AX = 0404H) 


This subfunction turns tracking on. For each movement of the logical device, V_ STRACK will be called 
to update the graphics cursor (sprite) location. 


On Entry: AH 
AL 
BP 


F IO CONTROL (04H) 
SF TRACK _ON (04H) 
V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF TRACK __OFF (AX = 0406H) 


This subfunction turns tracking off. 


On Entry: AH 
AL 
BP 


F_IO CONTROL (04H) 
SF_TRACK_OFF (06H) 
V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF CREATE _ EVENT (AX = 0408H) 


This subfunction establishes the routine to be called on logical device events. The IP, CS, and DS of the 
routine are passed to this subfunction. These values are exchanged with the vector entry of the 
V_EVENT_TABLET driver in the HP_VECTOR_TABLE, V_EVENT_TABLET being the parent of 
the logical tablet driver. The IP, CS, and DS of the previous routine are returned to the caller. Note that 
this subfunction does not enable the event call to the parent routine; this must be done explicitly using 
SF_EVENT_ON. 


The ISR event records passed to the V_EVENT_TABLET driver will have one of the following two 
formats depending on the data type stored in DL. 


Format |: 
V_EVENT TABLET Button ISR Event Record: 


AH = F_ISR (00H) 
DL = Physical device driver’s vector address / 6 
BX = Button information. 
Bit Value Definition 
OFH-O8H - Reserved 
O7H 1 Button up 
8) Button down 
O6H-OOH - Button number(0-7) 
DH = Data Type . 
ES:0 = Pointer to V LTABLET device driver header 


and Logical Describe Record. 
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Format 2: 
V_EVENT TABLET 


AH 
DL 
BX 
CX 
SI 
DH 
ES:0 


On Entry: AH 
AL 
BP 
DX 
SI 
ES 


On Exit: AH 
Dx 
SI 
ES 


R 


Registers Alter 


Related Functio 


Motion ISR Event Record: 


F ISR (OOH) 


Physical device driver’s vector address / 6 
A number between 0 and LD SIZE X 
A number between 0 and LD ) SIZE “Y 
A number between 0 and LD | SIZE _ Zz 


Data Type 


Pointer to V_TABLET device driver header and Logical 


Describe Record. 


F IO CONTROL (04H) 


SF CREATE _EVENT (08H) 


V_ LTABLET (OOBAH) 


DS of new V_ EVENT _ TABLET routine 
IP of new V_ EVENT _ “TABLET routine 
CS of new V_ EVENT | “ TABLET routine 


eturn Status Code 


ed: AX, DX, SI, BP, 


ns: SF_EVENT_ ON 


DS of previous V_EVENT TABLET routine 
IP of previous Vv EVENT | “TABLET routine 
CS of previous v_ EVENT _ “TABLET routine 


ES, DS 


This example shows how to use the SF_CREATE_EVENT function. The routine EVENT will be the 
event procedure that is called when events are enabled. 


EVENT PROC FAR 
CMP 


AH, F_ISR 3 


JE PROCESS EVENT 


MOV 
IRET 
PROCESS EVENT: 


MOV 
IRET 
EVENT ENDP 


MOV 
MOV 
MOV 
MOV 


PUSH 
POP 
LEA 
PUSH 
CALL 
POP 


AH, RS UNSUPPORTED 


we 


AH, RS SUCCESSFUL ; 


AH, F_I0 CONTROL 
AL, SF_CREATE_EVENT 
BP, V_LTABLET 

DX, DS ; 


cS 
ES 
SI, CS: EVENT 
DS 
SYSCALL 
DS 


we we we wo 
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only support function F_ISR 


code to process data (see 
tablet event record) 


return successful completion 


want to use the current data segment 
segment for event DS 


current CS is also segment of event routine 
get the IP of the event routine 

save current DS 

call extended BIOS driver 


SF__EVENT_ON (AX = 040AH) 


This subfunction enables the event (parent) call to the tablet event routine (V_EVENT__TABLET). The 
link to the tablet event routine must have already been established using SF_CREATE_EVENT. 


On Entry: AH 
AL 
BP 


F_ IO CONTROL (04H) 
SF_ EVENT_ ON (OAH) 
V_ LTABLET (OOBAH) 


On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 


Related Functions: SF CREATE EVENT, SF_EVENT_OFF 


SF EVENT OFF (AX = 040CH) 
This subfunction disables the call to the tablet event routine. 
On Entry: AH 


AL 
BP 


F_I0 CONTROL (04H) 
SF_EVENT OFF (OCH) 
V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CLIPPING _ ON (AX = 040EH) 


This subfunction enables logical device clipping. Physical device motion will be scaled to logical space and 
will be clipped to avoid overflow or underflow. Clipping is activated for both absolute and relative 
motion. 


When there is a relative device mapped to this device driver, clipping works the best. It will make sure 
that the new position always falls within the logical space. 


On Entry: AH 
AL 
BP 


F_IO CONTROL (04H) 
SF _CLIPPING ON (OEH) 
v_ LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__CLIPPING _ OFF (AX = 0410H) 


This subfunction disables logical device clipping. Physical device motion will be scaled to logical space, but 
overflow or underflow may occur. 


On Entry: AH 
AL 
BP 


F IO CONTROL (04H) 
SF_CLIPPING OFF (10H) 
V_LTABLET (OOBAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F SAMPLE (AH = O6H) 


This function allows an application to poll the tablet device. This function reports the current absolute 
position of the logical device in a form similar to a Logical ISR Event Record. 


On Entry: AH = F_SAMPLE (06H) 


BP = V_LTABLET (OOBAH) 

On Exit: AH = Return Status Code 

BX = Current logical position along X axis 

CX = Current logical position along Y axis 

SI = Current logical position along Z axis 

DL = LD TRANSITION field of Logical Describe Record 

DH = LD STATE field of Logical Describe Record 

ES:0 = Pointer to logical device header and Describe Record 


Registers Altered: AX, BX, CX, DX, BP, DS, ES 
The following is an example of how to call the F_SAMPLE function. 
PUSH BP, V_LTABLET 


MOV AH, F_SAMPLE ; load function code 
MOV BP, V_LTABLET ; load vector address 


PUSH DS ; save the current DS 
CALL SYSCALL ; call extended BIOS driver 


POP DS 3; restore DS 


Application Event Driver Example 


The following program is an example of how to input touchscreen data using application event interrupts. 
The program installs an application event driver using the SF_ CREATE EVENT function and enables 
event interrupts using the SF_EVENT_ON function. The event handler supports only the F_ISR 
function which processes both button and motion Logical ISR Event Records. 
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NOTE 


Since the HP interrupt number can change, all "int HP_ ENTRY" lines in 
the following example should be replaced with "CALL SYSCALL" (this 
routine finds and uses the current HP interrupt number). 





Touch Example 


286c¢ 


page 59,132 
title 


TOUCH Example 


,eaeeDRIVER HEADER == seunuwecasencesenssceeenuonceenenssusceuneusasancuas 


NAME : 


TOUCH Example 


DESCRIPTION: This program demonstrates how touch works. 


LIST OF SECTIONS: 


8000 


0010 
0060 
0000 
0000 
0006 
0006 


00 


page 
HP_SHEADER 
DH_ATR ; 
DH7NAME_ INDEX 


OH_V_ PARENT 
DH_V_ CHILO 
DH_MAJOR 
DH_MINOR 
HP_SHEADER 
HP ENTRY 
SYSCALL 
1fnb 


endif 


ATR_HP 
CL_NULL 

F_ISR 

F~IO_ CONTROL 
SF_CREATE EVENT 
SF EVENT OFF 

SF EVENT_ON 

RS SUCCESSFUL 
RS UNSUPPORTED 
T_KC_BUTTON 


T_TS 
V-DOLITTLE 
V~LTOUCH 
V_EVENT_TOUCH 
READ CHAR ECHO 
MAKE BREAK BIT 
TERMINATE PROC 


TS_EVENT_HEADR 
EXAM _HP_ATTR 


TLE .V_DOLITTLE> 


TS_EVENT_HEAOR 
DATA_SEG 


macro 
<vector> 
mov 


int 
endm 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 
equ 
equ 
equ 


segment 


he 
HP_SHEADE 


ends 
segment 


ooooo0o°cKdeo 


bp ,vector 
HP_ENTRY 


8000H 

0000H 

0000H 

0004H 

0008H 

000CH 

000AH 

0000H 

0002H 

09H ; reported PY. the ayer ce 
; PGID translates T_KC_IT 

any other scancode out 

4SH . Specially formed data 

0006H 

OOC6H 

0060H 


01H 
100000008 
4CH 


lver to the logical drive 
_KC_BUTTON and filters 
dafa stream 


80 x 0. 25 range - defa 


one 
@ea-<¢ 


ATR_HP 
<EXAM_HP_ATTR,V_EVENT_TOUCH/6.V_EVENT_TOUCH.CL_NULL CL_NULL,V_ 
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Touch Example (cont.) 


2222 SAVE_CS 
2222 SAVE IP 
ed SAVE DS 
50 [ STACK 
2722 
] 
2222 STK_TOP 
DATA_SEG 
CODE SEG 
BB ---- R BEGIN: 
BE D8 
8E DO 
8B 26 00AG R 
E8 001D R 
B4 01 INPUT_LOOP: 
CD 21 
3C 5E 
75 F8 
£8 0084 R EXIT PROG: 
B4 4C 
CO 21 
TOUCH_ENABLE 
B4 04 
le 
BO 08 
8C CB 
8E C3 
8D 36 0048 R 
BA ---- R 
BD 00C6 + 
CD 6F + 
aC CO 
A3 0000 R 
89 36 0002 R 
89 16 0004 R 
B4 04 
BO OA 
BD 00C6 + 
CD 6F + 
63 
TOUCH ENABLE 
TOUCH HANDLER 
80 FC 00 
74 03 
B4 02 
CF 
60 PROCESS_ISR: 
80 FE 45 
74 07 
80 FE 08 
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dw 
ends 
segment 
assume 
mov 
mov 
mov 
mov 
call 
mov 
int 
cmp 
jne 
call 
mov 
int 
proc 
mov 


mov 
mov 
mov 
lea 
mov 
syscall 


mov 
mov 
mov 
mov 
mov 
mov 
syscall 


ret 
endp 


proc 
cmp 
je 
mov 
fret 
pusha 
cmp 
je 
cmp 


O-v-v-v 


0 dup (7) 


cs:CODE_SEG,ds :DATA_SEG,ss DATA_SEG 


ax ,DATA_SEG 

ds ax 

38 ax 

aR nN Toe 

TOUCH_ENABLE 

ah READ CHAR ECHO 

21H 

al, 
INPUT _LOOP 

TOUCH RESTORE 

Br TERMINALES PROS 
1H 


ah. F_I0 CONTROL 


al, SF_CREATE_ EVENT 
bx.cs 


es bx 
si, TOUCH HANDLER 
dx, TS _EVENT_HEADR 


V_LTOUCH 
mov ae LTOUCH 
int HP_ENTRY 


axes 
word ptr SAVE_CS ax 
word ptr SAVE_IP,si 


;Save all the re 
-Is this a posit 


word ptr SAVE _DS,dx 
ah, F_ I0 CONTROL 

al SF EVENT_ON 
V_LTOUCH 

mov Bete LTOUCH 
int HP_ENTRY 
ah,F_ISR 

PROCESS ISR 

ah, RS_ UNSUPPORTED 
dh, 


TTS 
short POS REPORT 
dh, T_KC_BUTTON 


‘Read a character w/echo until 


‘Move my touch event 


Load up the ds register with the data segment 


-The stack segment is also in the code segment 
Point 


to the top of the stack 


mau 


-Is this the exit character? 


(Exit 


handler into the HP vector tab 


‘Save the old event values 


‘Start accepting calls 


-Logical interrupt? 


yes, continue 


‘set return code 


isters 


on report or a make/break report 


Touch Example (cont.) 


0059 74 OE je short BUTTON REPORT 
005B £EB 23 jmp short EXIT TOUCH 
005D B4 02 POS REPORT: mov ah,02H Move the cursor to the recieved position 
OOSF 8A Fl mov dh. cl using the standard IBM BIOS int 10 
0061 8A D3 mov dl.bl 
0063 B? 00 mov bh.0 
0065 CD 10 int 10H 
0067 EB 1? jmp short EXIT TOUCH .That finishes that ISR 
0069 FE C3 80 BUTTON REPORT: est bl. MAKE BREAK BIT .See if this is a touch or a release 
006C 74 OA jz short BUTTON PUSH 
OO6E BS OE mov ch,OEH -On a release make the cursor back into 
0070 Bi OF mov cl. OFH .a line 
0072 B4 01 mov ahil 
0074 CD 10 int 10H 
0076 EB 08 jmp short EXIT TOUCH .That finishes a release ISR 
0078 BS 00 BUTTON PUSH mov ch.0 Make the cursor into a box on touch 
007A Bl OF mov cl,Ofh 
007C B4 Ol mov abl 
O07E CD 10 int 10H 
0080 61 EXIT_TOUCH: popa Restore all the registers 
008i B4 00 mov ah, RS SUCCESSFUL Set the return status 
0083 CF iret Return from the ISR 
0084 TOUCH HANDLER endp 
0084 TOUCH RESTORE proc 
0084 Ba 04 mov ah. Ff IO CONTROL ‘Stop accepting calls 
0086 80 OC mov al, SF_EVENT_OFF 
syscall V_LTOUCH 
0088 BD 00CE6 + mov eRe LTOUCH 
008B CD 6F + int HP ENTRY 
008D B4 04 mov ah. F_I0 CONTROL Restore the old event handler 
008F BO 08 mov al, SF_CREATE EVENT 
0091 8B 1E 0000 R mov bx word ptr SAVE CS 
0095 8E— C3 mov es bx 
0097 8D 36 0002 R lea si.word ptr SAVE IP 
009B 8B 16 0004 R mov dx.word ptr SAVE DS 
syscall V_LTOUCH 
OOSF BD 00CE6 + mov PBee LTOUCH 
0OA2 CD 6F + int HP_ENTRY 
00A4 C3 ret 
O0AS TOUCH RESTORE endp 
00A5 CODE _ SEG ends 
end BEGIN 
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Touch Example (cont.) 


Macros: 

Name 
SYSCALL. 
Structures and records: 


HP greeeen 
BH 


OH_ NAME. INDEX. 
DH_V_OEFAULT . 


DH_MINOR 
Segments and Groups: 
Name 
CODE_SEG 
DATA_SEG 
TS_EVENT_ HEAOR 
Symbols: 


BUTTON PUSH. . 
BUTTON REPORT. 


CL_NULL. 
EXAM HP_ATTR . 
EXIT-PROG. . . 
EXIT-TOUCH 
F_IO-CONTROL . 
FISK... 
HP_ENTRY |. 
INPUT _LOOP _ 
MAKE BREAK BIT 
POS REPORT... 
PROCESS ISR. 
READ CHAR ECHO 
RS SUCCESSFUL. 
RS_UNSUPPORTED 
SAVE CS... .. 
SAVE_DS 

SAVE — 


Pp. 
SF _CREATE_ _EVENT. 


SF_EVENT_OFF 
SF EVENT _ON 
STACK. . 

STK TOP. 
TERMINATE PROC 
TOUCH ENABLE 
TOUGH” HANDLER 
TOUCH RESTORE 
T_KC_ BUTTON 
TTS" ; 
VIDOLITTLE | 
W-EVENT. TOUCH 
VILTOUCR 


48576 Bytes free 


Warning Severe 
arr eran 
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Length 
0002 


Number 


Number 
Number 
L WORD 
L wORD 
Number 
N PROC 
N PROC 
N PROC 
Number 
Number 
Number 
Number 
Number 


COTDDDSCDOOCOCOOCCCOCOOP OOS 


@ fields 


Widt 
0009 


0000 


o@o 


PoP -2-T-8-1- 1-1-1 -1- 1-2-2 2- -eel oe 
COCK KCDCUMUBORAOCa-BOQ~a 
ONRONOr-OTOMNS ROAM 


h 


Mask 


Combine Class 


NONE 
NONE 
NONE 


Attr 


CODE SEG 
CODE_SEG 
CODE_SEG 


CODE_SEG 
CODE_SEG 


CODE_SEG 


CODE_SEG 
CODE_SEG 


DATA_SEG 
DATA_SEG 
DATA_SEG 


DATA_SEG 
DATA_SEG 


CODE_SEG 
CODE_SEG 
CODE SEG 


Initial 


Hardware Interface Level 


The hardware interface of the Input System is composed of a set of drivers to respond to hardware 
interrupts and to process physical data from the input devices into a form usable by the application 
interface drivers. These hardware interface level drivers are shown in Figure 4-2. 


Overview 


This section describes the drivers, data structures, and interrupt service routine (ISR) event processing 
that takes place below the application interface level. The following data flow expands on step 2 of the 
data flow presented previously. A detailed explanation of each step is presented after the data flow. 


1. The user touches the screen. This causes a hardware interrupt which is managed by the 8259A’s 
interrupt controller service (V_S8259). V_S8259 responds to the interrupt controller chip and 
transfers control to the HP~-HIL driver. 


2. The HP-HIL driver (V_HPHIL) services the HP-HIL controller chip, retrieving the input device 
data. V_HPHIL processes the input data and transfers control to the Input System dispatch service. 


3. The dispatch service (V_SINPUT) transfers control to the appropriate physical device driver based 
on the source of the input data (in this case the physical touchscreen driver). 


4. The physical touchscreen driver builds the Physical Describe Record and transfers control to the 
application interface driver V_LTOUCH. 


V__S8259 provides a funnel point for managing HP specific hardware. The Input System hardware 
communicates with the hardware interface drivers via two interrupts: the 8042 service request (SVC) and 
the HP-HIL controller interrupt. The HP-HIL controller interrupt is chained to the HP-HIL driver 
(V__HPHIL); ie., when V_S8259 receives an HP-HIL controller interrupt it generates an HP_ENTRY 
software interrupt to transfer control to V_HPHIL. 


The HP-HIL driver services the HP-HIL controller and generates the appropriate Physical ISR Event 
Record(s). After processing the input data, V_HPHIL chains to V_SINPUT. 
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Application 


Application 
Interface 
Drivers 


Application Interface Level 







Touch Screen Pointer 
Physical GID Physical GID 
Driver Driver 


Input Dispatch 
Service 
(V_SINPUT) 


Tablet 
Physical GID 
Driver 


HP-HIL Controller 
Driver 
(V_HPHIL) 


8259A Interrupt 
Controller Driver 
(V_S8259) 


Hardware Interface Level 


Physical input Devices 


Figure 4-2. Hardware Interface Level Drivers 


V__SINPUT chains to the appropriate physical device driver based on the vector index (vector address 
divided by six) stored in the Physical ISR Event Record (DL register). It provides an entry point into the 
Input System for non-HP-HIL devices. V_SINPUT also provides driver mapping functions that will be 
discussed later in this chapter. 


Two physical drivers will be discussed later in this chapter. The first is the physical GID driver (PGID), 
which handles both absolute and relative data. Because PGID can handle both types of GID data, it can 
chain to any logical GID driver; this forms the basis for Input System device driver mapping. The second 
physical driver is the null device driver (V_PNULL), which serves as a handler for unsupported devices. 


Device Driver Mapping 


Each driver in the Input System has a vector in the HP_VECTOR_ TABLE, and a driver header. Each 
driver header has two fields which determine the mapping of the driver. One field contains the vector of 
the driver’s parent driver, and the other contains the vector of the driver’s child driver. Refer to Chapter 
2 and Appendix G for a detailed description of driver headers. 


Calls are made to the vector address contained in the parent field to pass the interrupt on to the next 
driver in the device driver chain, moving the data from the hardware toward the application via the 
desired logical GID driver. Hardware commands from the application are passed down the device driver 
chain to the device via the vector address contained in the child vector field. By changing the value of 
the parent or child vector field, the sequence of drivers called to handle an interrupt or function request 
is changed. In general, an application may re~map a driver by changing the driver header directly. 
Functions are provided by the V_SINPUT service to map the physical GID drivers to the logical GID 
drivers. 
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Device Emulation 


Device emulation occurs when one or more physical devices are mapped to a logical device that does not 
represent the original source of the data. For example, mapping a physical mouse driver to a logical 
touchscreen driver allows the mouse to look like a touchscreen to the application. The key requirement 
for a logical device driver to emulate other devices is that it accept both absolute and relative data. The 
logical touchscreen driver which reports absolute data must accept both absolute (touch) data and relative 
(mouse) data. | 


An example of device mapping and emulation occurring in the system is the translation of mouse input to 
Cursor Control keypad (CCP) input. Since standard DOS processes keyboard input only, (not mouse 
input), the physical GID driver which processes mouse input is mapped, in its default state, toa driver 
called V_PGID_-CCP. This driver causes mouse input to emulate input from the CCP. For an application 
which processes industry standard mouse input (INT 33H) to use the HP Mouse, the mouse physical GID 
driver should be mapped to the installable HP-HIL Mouse Driver (V_LHPMOUSE), using the HP-HIL_ 
mouse driver’s F33_ INSTALL function. (Note that the HP-HIL Mouse Driver is shipped on a separate 
disc with all ES, QS, and RS Vectra series computers ) 


Data Structures 


The hardware interface level uses two major data structures: the Physical Describe Record and the 
Physical ISR Event Record(s). These data structures help keep track of the numerous events occurring in 
the Input System. 


Physical Describe Record 


The Physical Describe Record is used by the physical GID drivers to keep track of the current state of 
their respective devices. Each of the physical GID drivers has a Physical Describe Record located directly 
after the driver header, starting with memory address DS: 0010H. Table 4-7 gives the field types and 
offsets of the Physical GID Device Describe Record. An explanation of the Physical Describe Record 
fields follows 


Table 4-7, Physical GID Device Describe Record 


Field Description Offset 
Driver Header Driver Header 00H 


D_SOURC Input type and device 
address 


D_HPHIL_ID Device ID 


D_DESC MASK Describe header byte 
D_IO_MASK Device I/O descriptor byte 


D_XDESC_MASK Extended describe header 
‘| byte 
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Table 4-7. Physical GID Device Describe Record (Cont.) 


Field Description Offset 
Driver Header Driver Header 00H 


D_MAX AXIS Maximum number of axes 







D_CLASS Device class 






D_PROMPTS Number of button/ prompts 


D_ PARAGRAPHS This record size in 


paragraphs 






D_BURST_LEN Maximum output burst 


length 






D_WR_REG Number of write registers 







D_RD_ REG Number of read registers 


Button transitions 






D_ TRANSITION 


D_STATE Current state of the 


buttons 






D_RESOLUTION Physical device resolution 







D_SIZE_X Maximum x-axis count 






D_SIZE_Y Maximum y-axis count 






D_ABS X X position data for absolute 


devices 






D_ABS Y Y position data for absolute 


devices 






D_ REL X X delta for relative devices 










D_REL Y Y delta for relative devices 
D ACCUM X Reserved 
D_ACCUM_Y Reserved 









D_ SIZE Z Maximum Z-axis count 





D_ABS Z Z position data for absolute 


devices 


Z delta for relative devices 






D_ REL Z 





D_ ACCUM Z Reserved 
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Physical Device Record Definition 


D SOURCE 


D_HPHIL_ID 


D_DESC_ MASK 


D_IO_ MASK 


D_XDESC_MASK 


D_MAX_AXIS 


D_ CLASS 


D_ PROMPTS 


D_PARAGRAPHS 


D_BURST_LEN 


D_WR_REG 


D_RD_REG 


D_ TRANSITION 


D_ STATE 


D_RESOLUTION 


D_SIZE_X 


D_SIZE_Y 


This field is divided into nibbles. Bits 7-4 contain the graphics input 
device type. This field is loaded with the low order nibble of the ap- 
propriate physical GID data type. (See Table 4-8.) Bits 3-0 are the link 
address of the physical device. 


ID byte of the physical device which last reported data. See Table 4-2 


for a list of HP-HIL ID bytes. 


Physical device describe byte. This byte contains information about the 
physical device characteristics. See the HP-HIL Technical Reference 
Manual for more information. 


Physical device I/O descriptor byte. This byte contains information on 
the number of prompts and acknowledges the device supports. See the 


HP-HIL Technical Reference Manual for more information. 


Physical device extended describe byte. This byte contains additional 
device characteristics. See HP-HIL Technical Reference Manual for more 
information. 


Maximum number of axes supported by the device. Valid range is 0-2. 


Device class. Bits 7-4 contain the current class. Bits 3-0 contain the 
default class. See Appendix G for more information on device classes. 


Number of buttons and prompts supported by the device. Bits 7-4 is the 
number of prompts. Bits 3-0 is the number of buttons. 


Indicates size of this record in paragraphs: 0 means 3 paragraphs, | 
means 4 paragraphs. 


Maximum number of bytes that can be output to the device using a 
single write command. 


Number of write registers supported by the device. 

Number of read registers supported by the device. 

Transitions reported per button; i.e. a set bit indicates that the cor- 
responding button was either pushed or released. Bit 7 corresponds to 
button 7, etc. 

Current state of the buttons. 0 is down, | is up. Bit 7 corresponds to 
button 7, etc. If D_ STATE is XOR’ed with D_TRANSITION the result 
is the previous button state. 

This is the resolution of the physical device. The resolution is in counts 
per meter for devices that report 8 bits of data. For devices that report 
16 bits of data, the resolution is in counts per centimeter. 


Maximum count (in units of resolution) for the x-axis. 


Maximum count (in units of resolution) for the y-axis. 
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D_ABS_ X 


D_ABS_ Y 


D_REL_ X 


D_REL_Y 


D_SIZE_Z 
D_ ABS Z 


D_ REL Z 


X position data for devices which report absolute coordinates (absolute 
devices). 


Y position data for devices which report absolute coordinates. 


Latest change in x position for devices which return coordinates relative 
to the previous position (relative devices). 


Latest change in y position for devices which return coordinates relative 
to the previous position. 


Maximum count (in units of resolution) for the z-axis . 
Z position data for devices which report absolute coordinates. 


Latest change in z position for devices which return coordinates relative 
to the previous position (relative devices). 


Physical ISR Event Records 


A Physical ISR Event Record is not a data structure in the truest sense, but is a set of register definitions 
for inter-driver communication of input events. The following define the Physical ISR Event Records. 


GID Button ISR Event Record 


AH = F_ISR (00H) 
DL = Physical devic 
BX = Button informa 
Bit Value 
OFH-O8H 
O7H 1 
0 
O6H -OOH 
DH = Data Type 
ES:0 = Pointer to phy 


header and Phy 


e driver’s vector address / 6 
tion. 


Definition 


Reserved 

Button up 

Button down 

Button number (0-7) 


sical device driver 
sical Describe Record. 


GID Motion ISR Event Record 


AH = F_ISR (00H) 
DL = Physical devic 
BX = X axis motion 
CX = Y axis motion 
SI = Z axis motion 
DH = Data Type 

ES:0 = Pointer to phy 


header and Phy 


e driver’s vector address / 6 
in raw data form. 
in raw data form. 
in raw data form. 


sical device driver 
sical Describe Record. 
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The button number in the Button Transition Information field (BX) denotes which button on the device 
is reporting data. Of special interest is button seven (proximity indicator), which is currently used by 
absolute devices to indicate that the device measurement field is active; ie., someone is touching the 
touchscreen, or the stylus is in contact with the tablet surface. 

The Data Type field (DH) contains a code representing the current type of physical GID data stored in 
the event record. For button events, this value will be T_KC BUTTON. For a complete list of physical 
GID event data types see Table 4-8. 


Table 4-8. Physical GID Event Data Types 


T_KC_ BUTTON Button data. 
T_RELO8 Signed 8 bit relative data 


T_REL16 Signed 16 bit relative data 


T_ABSO8 Unsigned 8 bit absolute data 


T_ABS16 Unsigned 16 bit absolute data 





Hardware Interface Level Drivers 


This section describes the hardware interface level drivers in detail. 


V__$8259 Driver (BP = OO1EH) 


The V_ 88259 driver services the HP interrupt. Three interrupt sources will genterate this interrupt: the 
8042 SVC (Service port) service request, the HP-HIL controller, and the 8042 SCAN interrupt. 


When an HP interrupt occurs, the V_S8259 driver will determine the source of the interrupt and 
perform an F __ISR call to one of the three drivers: 


m the V_ 8042 driver for an 8042 SVC interrupt, 
m@ the V_HPHIL driver for an HP-HIL controller interrupt, 
m the V_SCANDOOR driver for a SCAN interrupt. 


In addition to initiating response to the hardware interrupts, the 8259A driver has other functions which 
initialize the interrupt vectors and program the proper parameters into the 8259A interrupt controllers. 
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V__$8259 Driver Function Definitions 
A summary of the V_S8259 function codes is provided in Table 4-9. 


Table 4-9. V_S8259 Function Code Summary 


Function Vector Func. 
Equate Definition Address Value 


V_S8259 8259 interrupt controller 
support 





F_ SYSTEM System functions 
SF_INIT Initialize HP-HIL IRQ 


SF START Enable HP-HIL interrupts 


SF_VERSION _ DESC Report HP version number 


SF_GET_IRQ Get HP IRQ number 


F ISR (AH = 00H) 


Because this driver directly services hardware interrupts from an 8259A interrupt controller, this 
function is not applicable. If called, this function will return a Return Status Code of . 
RS UNSUPPORTED. 


SF_INIT (AX = 0200H) 


This subfunction sets the interrupt vectors for the HP-HIL IRQ (default IRQ 12). This subfunction leaves 
interrupts disabled. They must be enabled with the SF_START subfunction. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_INIT (00H) 
V_S$8259 (001EH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF START (AX = 0202H) 
This subfunction enables the HP-HIL interrupts. 
On Entry: AH 


AL 
BP 


F_SYSTEM (02H) 
SF_START (02H) 
V_S$8259 (001EH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF VERSION _ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960, and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_ SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_S$8259 (001EH) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF GET _ IRQ (AX = 0414H) 
This function gets the current IRQ number associated with the SCAN/STATE/HIL/SVC interrupts. 
On Entry: AH 


AL 
BP 


F_IO CONTROL (04H) 
SF_GET_IRQ (14H) 
v_§8259 (001EH) 


On Exit: AH 
BL. 


RS_SUCCESSFUL (00H) 
Current IRQ 


thou 


Registers Altered: AX, BX, BP, DS 


V__HPHIL Driver (BP = 0114H) 


The HP-HIL driver retrieves input data from the HP-HIL controller and builds an ISR Event Record to 
pass to V_ SINPU7. 


A summary of the V_HPHIL driver function codes is provided in Table 4-10. 
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V__HPHIL 


F_ISR 
F_ SYSTEM 
SF_INIT 
SF_REPORT 
_ STATE 


SF_VERSION 
_DESC 


SF_OPEN 


SF_ CLOSE 


F_1O0_CONTROL 


SF_CRV_CRV 
_MAJ_MIN 


SF_CRV 
__RECONFIGURE 


SF_CRV_WR 
__PROMPTS 


SF_CRV_WR 
_ACK 


SF_CRV 
_REPEAT 


SF_CRV 
_ DISABLE 
_ REPEAT 


Table 4-10. V_HPHIL Driver Function Code Summary 


Function Vector Func. 
Equate Address Value 


Set up HP-HIL to 
INPUT driver 
linkage 


Logical Interrupt 
System Functions 


Initializes the driver 
data area. 


Reports state of 
device 


Reports driver ver- 
sion number. 


Put driver in open 
state. 


Put driver in closed 
state. 


1/O control to 
driver 


Reserved 


Forces HP-HIL to 
reconfigure all 
devices. 


Writes a prompt to 
a device 


Writes an acknow- 
ledge to a device 


Sets either 30Hz or 
60Hz repeat rate 


Cancels keyboard 
repeat rate 
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Table 4-10. V_HPHIL Driver Function Code Summary (Cont.) 


Function Vector Func. 
Equate Address Value 





SF_CRV 
_SELF_TEST 


SF_CRV 
_ REPORT 
_ STATUS 


SF_CRV 
__REPORT_NAME 


SF_GET 
_DEVTBL 


SF_SET _DEVTBL 
SF_ DEF 
_DEVTBL 


F_PUT_BYTE 


F_GET_BYTE 


F_PUT_BUFFER 


Issues self-test 
command to physi- 
cal device. 





Gets status from 
any HP-HIL device 
that needs to report 


Returns the ASCII 
name for a device 


Gets physical device 
table address 


Sets physical device 
table address 


Sets default physical 
device table 


Writes one byte to 
specified HP-HIL 
device. 


Reads one byte 
from specified 
HP-HIL device. 


Writes a string of 


bytes to HP-HIL 
device. 
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V__HPHIL Driver Function Definitions 


_ F__ISR (AH = OOH) 


This function is called by the V_S8259 driver to initiate processing of an interrupt from the HP-HIL 
controller. This function reads input device data from the HP-HIL controller, generates one or more ISR 
Event Records, and chains to V_SINPUT. THIS FUNCTION SHOULD ONLY BE CALLED BY THE 
V_S8259 DRIVER. 


On Entry: AH 
BP 


F_ISR (00H) 
V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__INIT (AX = 0200H) 


This subfunction initializes the driver and HP-HIL controller. Refer to Chapter 8 for a complete 
discussion of the protocol utilized in data space allocation ("last used DS" passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_INIT (00H) 
BX = "Last used DS" in HP Data Area 
BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 
BX = New “last used DS" in 
HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF_ REPORT STATE (AX = 0204H) 
This subfunction returns the current status of V_HPHIL. 


On Entry: AH = F_SYSTEM (02H) 


AL = SF REPORT STATE (04H) 
BP = V_HPHIL (0114H) 
On Exit: AH Return Status Code 


BX Status word 
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Bit Value Definition 


OFH Reserved 
OEH 1 HP-HIL is OFF 
0 HP-HIL is ON 
ODH Reserved 
OCH 1 Timeout has occurred 
OBH 1 Output request has completed 
OAH Reserved 
OSH 1 Error during output request 
O8H 1 HP-HIL link has been reconfigured 
O7H Reserved 
O6H 1 HP-HIL driver is open 
8) HP-HIL driver is closed 
O5H-04H Reserved 
03H 1 General failure 
02H 1 No devices attached. 
01H Reserved . 
OOH 1 Link configuration in progress 


Registers Altered: AX, BX, BP, DS 


SF__VERSION _ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_HPHIL (0114H) 


On Entry: AH 
AL 
BP 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF_ OPEN (AX = 020EH) 


This subfunction puts the HP-HIL driver in the open state. When the driver has been placed in the open 
state, output to the HP-HIL devices is allowed. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_OPEN (OEH) 
V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF __CLOSE (AX = 0210H) 


This subfunction puts the HP-HIL driver in the closed state. When the driver has been placed in the 
closed state, output to the HP-HIL devices is not allowed. 


On Entry: AH 
AL 
BP 


F SYSTEM (02H) 
SF _CLOSE (10H) 
V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV __RECONFIGURE (AX = 0406H) 
This subfunction instructs the HP-HIL controller to reconfigure the link. 
On Entry: AH 


AL 
BP 


F_I0 CONTROL (04H) 
SF_CRV_RECONFIGURE (06H) 
V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CRV__WR __ PROMPTS (AX = 0408H) 


This subfunction issues a prompt command to a device on the HP-HIL link. The prompt command is 
either specific (prompt number 1-7) or generic (a prompt number other than 1-7). . 


On Entry: AH = F_IO CONTROL (04H) 

AL = SF_CRV_WR_PROMPTS (08H) 

BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH 

0 Reserved for future enhancement, 
currently returns RS FAIL 

OCH 1 Valid register is present in DL 
OBH-OOH Reserved 

DH = HP-HIL device address 

DL = Prompt number 

BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__CRV__WR _ ACK (AX = 040AH) 


This subfunction issues an acknowledge command to a device on the HP-HIL link. The acknowledge 
command 1s either specific (acknowledge number 1-7) or generic (an acknowledge number other than 
1-7). 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_CRV_WR_ ACK (OAH) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, 
currently returns RS FAIL 
OCH 1 Valid register is present in DL 
OBH-OOH Reserved 
DH = HP-HIL device address (major address) 
DL = Acknowledge number 
BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CRV _ REPEAT (AX = 040CH) 


This subfunction sets the key repeat rate of a specific HP-HIL device. A repeat rate of 30 or 60 times a 
second may be specified. This subfunction will operate only if the HP-HIL driver is in the open state. 


On Entry: AH F IO CONTROL (04H) 


AL = SF_CRV_REPEAT (OCH) 
BX = Device address indicator 
Bit Value Definition 
OF H-OEH Reserved. 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved. 
CL = 0 for a repeat rate of 30 Hz, 1 for 60 Hz 
DH = HP-HIL device address (major address) 
BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__CRV _DISABLE _REPEAT (AX = 040EH) 


This subfunction disables the key repeat of a specified HP-HIL device. This subfunction will operate only 
if the HP-HIL driver is in the open state. 


On Entry: AH = F_IO CONTROL (04H) 


AL = SF _CRV_ DISABLE _REPEAT (OEH) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
DH = HP-HIL device address (major address) 
BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__CRV__SELF__TEST (AX = 0410H) 


This subfunction initiates device self-test on the specified HP-HIL device. The HP-HIL device will 
respond with a one byte status code indicating the result of the test. This subfunction should not be called 
with an HP-HIL device address of zero (all devices), as the test could then take up to 1.5 seconds to 
execute. Also, if one of the devices fails, there would be no way to determine which device reported a 
failure. 


On exit, the buffer has the return status of the self-test done on the physical device. 


On Entry: AH = F IO CONTROL (04H) 


AL = SF_CRV_SELF_TEST (10H) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH 
0 Reserved for future enhancement, 
currently returns RS_FAIL 
OCH 1 Valid register is present in DL 
OBH-OOH Reserved 
DH = HP-HIL device address (major address) 
BP = V_HPHIL (0114H) 
ES:SI = Pointer to a buffer area 
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On Exit: AH = Return Status Code 
ES:SI = Pointer to buffer area 
CX = Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 


SF_CRV _REPORT _ STATUS (AX = 0412H) 


This subfunction issues a send status command to a specified HP-HIL device. The returned status 
information ranges from 1 to 15 bytes in length. A pointer to a 15 byte buffer must be passed to the 
subfunction. This subfunction will operate only if the HP-HIL driver is in the open state. 


On Entry: AH F 10 CONTROL (04H) 


AL = SF_CRV_REPORT_STATUS (12H) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
DH = HP-HIL device address (major address) 
BP = V_HPHIL (0114H) 
ES:SI = Pointer to a buffer area 


On Exit: AH 
ES:SI 
CX 


Return Status Code 
Pointer to buffer area 
Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 
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SF__CRV _REPORT_ NAME (AX = 0414H) 


This subfunction issues a report name command to a specified HP-HIL device. The returned name 
information ranges from 1 to 15 bytes in length. A pointer toa 15 byte buffer must be passed to the 
subfunction. This subfunction will operate only if the HP-HIL driver is in the open state. 


On Entry: AH = F_IO CONTROL (04H) 


AL = SF_CRV_REPORT_ NAME (14H) 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
DH = HP-HIL device address (major address) 
BP = V_HPHIL (0114H) 
ES:SI = Pointer to a buffer area 


On Exit: AH 
ES:SI 
CX 


Return Status Code 
Pointer to buffer area 
Number of bytes in buffer 


Registers Altered: AX, CX, BP, DS 


F__PUT_ BYTE (AH = 06H) 


This function outputs a byte of data to a specific HP-HIL device register. This function will operate only 
if the HP-HIL driver is in the open state. 


On Entry: AH = F_PUT_BYTE (06H) 


AL = Byte to output 
BX = Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
DH = HP-HIL device address 
DL = HP-HIL device register (0-127) 
BP = V_HPHIL (0114H) 


On Exit: AH = Return Status Code 
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Registers Altered: AX, BP, DS 


F  GET_ BYTE (AH = 08H) 


This function returns the contents of a specific HP-HIL device register. This function will operate only if 
the HP-HIL driver is in the open state. 


On Entry: AH F_GET_ BYTE (08H ) 


BX Device address indicator 
Bit Value Definition 
OFH-OEH Reserved 
ODH 1 | Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
DH = HP-HIL device address 
DL = HP-HIL device register (0-127) 
BP = V_HPHIL (0114H) 


On Exit: AH 
AL 


Return Status Code 
Contents of specified register 


Registers Altered: AX, BP, DS 


F PUT__BUFFER (AH = 0AH) 


This function outputs a buffer to a specific HP-HIL device register. The HP-HIL controller and devices 
are capable of data transfer at rates up to 6500 bytes per second. If the number of bytes in the buffer is 
greater than the number the HP-HIL device can handle, this function will transfer as many bytes as 
possible to the device, and adjust the value in CX to reflect the number of bytes left in the buffer (not 
sent to the device). 


On Entry: AH = F_PUT_BUFFER (OAH) 


BX Device address indicator 
Bit Value Definition 
OF H-OEH Reserved 
ODH 1 Valid address is present in DH. 
0 Reserved for future enhancement, 
currently returns RS FAIL. 
OCH 1 Valid register is present in DL. 
OBH-OOH Reserved 
CX = Number of bytes in buffer 
DH = HP-HIL device address 
DL = HP-HIL device register (0-127) 
BP = V_HPHIL (0114H) 
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ES:SI = Pointer to buffer containing data to output 


On Exit: AH 
CX 


Return Status Code 
O means all the data in buffer is transferred, 
otherwise the number of bytes left in buffer. 


Registers Altered: AX, CX, BP, DS 


SF__GET_ DEVTBL (AX = 0420H) 


This function returns the address and size of the physical device table (listed in Table 4-11 ). 


On Entry: AH 
AL 
BP 


F_IO CONTROL (04H) 
SF_GET_DEVTBL (20H) 
V_HPHIL (0114H) 


On Exit: AH 
DS: 
CX 


RS SUCCESSFUL (00H) 
I = Address of current physical device table 
Number of table entries 


unu 


Registers Altered: AX, CX, SI, BP, DS 


Table 4-11. Physical Device Table 


P_ID_LOWER HPHIL ID lower 
bound 


P_ID UPPER HPHIL ID up- 
per bound 


P_ OFFSET Offset of driver 
entry point 


P_CS Segment of 


driver entry 
point 


P_ HEADER . Header for 
physical driver 


P_CLASS Device driver 
class: 
Bits 7-4 current 
class 
Bits 3-0 default 
class 
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Table 4-11. Physical Device Table (Cont.) 


P_ TYPE ISR event 
record type 


P_EXTRA_ DS Pointer to Extra 
DS maintained 


by the device 
driver 





Both the SF_GET_DEVTBL and SF_ SET DEVTBL are intended to be used by installable HP-HIL 
device drivers that need to provide their own physical describe record. For the HP Vectra series of 
computers, the installable HP-HIL device driver can request the address and function, copy the table to 
local RAM, add any special entries it needs to the table, and then set the new table’s address by issuing 
the SF_SET_DEVTBL function. The advantage of this is that once the HP-HIL device driver is installed, 
and its new entries added into the table, it will always be recognized by the system even during a loop 
reconfiguration. 


The P_EXTRA_DS is for the device drivers use. It should hold the segment address of any additional 
data area that the device may require. This field (P_EXTRA_ DS) will not be altered by the system 
when reconfiguring the HP-HIL loop. 


SF. SET_DEVTBL (AX = 0422H) 
This function sets the new address and size of the physical device table. 


F_IO CONTROL (04H) 

AL = SF _SET_ DEVTBL (20H) 

BP = V_ HPHIL (0114H) 

ES:DI = Address of a physical device table 
CX = Nuaber of entries in table 


On Entry: AH 


On Exit: AH = RS SUCCESSFUL (00H) 


Registers Altered: AX, CX, SI, BP, DS 


SF__SET_DEVTBL (AX = 0424H) 


This function resets the physical device table to default power-on values. 


F_I0 CONTROL (04H) 
SF_DEF DEVTBL (24H) 
V_HPHIL (0114H) 


On Entry: AH 
AL 
BP 


On Exit: AH RS _ SUCCESSFUL (00H) 


Registers Altered: AX, BP, DS 
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V__SINPUT (BP = 002AH) 

The V_SINPUT driver dispatches ISR events generated by the HP-HIL controller to the appropriate 
physical driver, thus providing an entry point into the Input System for non-HP-HIL devices (1.e., 
RS~-232 mice, tablets, etc.). It also provides a number of functions which support device mapping. 


A summary of the V_SINPUT driver function codes is provided in Table 4-12. 


Table 4-12. V_SINPUT Driver Function Code Summary 


Function Vector Func. 
Equate Definition Address Value 


V_SINPUT Inquire Commands 002AH 





F_ISR Pass ISR event record to 002AH 
physical driver 


F_ SYSTEM System Functions 002AH 
SF_INIT Initialize driver 002AH 


F_IO0 _CONTROL Entry point to IO control 002AH 
functions 


SF_DEF _ LINKS Set header link fields to 002AH 
system defaults 


SF_GET _ LINKS Return device header link 002AH 
field entries 


SF_SET _ LINKS Set device header link field 002AH 
entries 


F_INQUIRE Return describe record for 002AH 
an HP-HIL device. 


F_INQUIRE ALL Return device IDs for all 002AH 
HP-HIL devices present 


F_INQUIRE _ FIRST Return vector address of 002AH 
first HP-HIL device driver. 


F_REPORT _ENTRY Report entry point of PGID 002AH 
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V__SINPUT Driver Function Definitions 


F__ISR (AH = 00H) 


This function passes an ISR Event Record to the appropriate physical device driver based on the value in 

DL. Non-HP-HIL devices which call V_SINPUT must provide the physical device driver that will handle 
the ISR event record, and must place its vector index (vector address divided by six) in DL. (See Chapter 

8, V_SYSTEM functions, to obtain a valid vector address). 


On Entry: AH F_ISR (00H) 
BP = V_SINPUT 
(See tables 4-6 and 4-7 for other register values) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF _ INIT (AX = 0200H) 
This subfunction initializes the driver. 
F SYSTEM (02H) 


SF_INIT (00H) 
V_SINPUT (002AH) 


On Entry: AH 
AL 
BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__DEF _ LINKS (AX = 0400H) 


This subfunction sets the parent vectors in the HP-HIL physical device driver headers to the system 
defaults shown in Table 4-13. The child vector entries are set to the null device driver (V_PNULL) by 
default (see Appendix F). 


Table 4-13. Default Physical Device Driver Parents 


Mouse V_PGID_CCP 
Tablet V_LTABLET 


Touchscreen V_LTOUCH 
Barcode Reader V_PNULL 
Rotary Knob V_PGID_CCP 
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On Entry: AH 
AL 
BP 


On Exit: AH = 


F_I0 CONTROL 
SF_DEF_LINKS 


(04H) 
(00H ) 


V_SINPUT (002AH) 


Return Status Code 


Registers Altered: AX, BP, DS 


SF__GET__LINKS (AX = 0402H) 


This subfunction returns the current parent and child vectors in the HP-HIL physical device driver 
headers. The address of a seven word (14 byte) table is passed to the subfunction. When the subfunction 
returns, the buffer will contain the current vectors. See Table 4-14 for the mapping buffer format. 













On Entry: AH 


On Exit: AH 
ES:SI 


Table 4-14. Mapping Buffer Format 


F_I0 CONTROL 
SF_GET_LINKS 


(04H ) 
_GET_ (02H) 
V_SINPUT (OO02AH ) 
Pointer to table 


Return Status Code 
Pointer to table 


Registers Altered: AX, BP, DS 


SF__SET__LINKS (AX = 0404H) 





Device 
“ 


#1 
“ 2 
"“ 3 
te 4 
1 5 
i] 6 
s 7 


This subfunction sets the parent and child vectors in the HP-HIL physical device driver headers. The 
address of a seven word (14 byte) table is passed to the subfunction. The table contains the new parent 
and child vectors for the drivers. The format of the buffer is shown in Table 4-14. . 


On Entry: AH 


On Exit: AH 


F_IO CONTROL (04H) 
SF SET LINKS (04H) 


V_SINPUT (002AH) 
Pointer to table 


Return Status Code 


Registers Altered: AX, BP, DS 
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The following example is how to use the SF_SET__LINKS function. It is presumed that a call to 
F_ INQUIRE ALL has been made, and that the device is a tablet. The tablet is going to be mapped to 
the installable HP-HIL Mouse driver (V_LHPMOUSE). The BX register already has the offset into the 


buffer of tablet mappings. 


BUFFER DW 7 DUP (?) 
MOV CX, BUFFER[BX] 
MOV CH, V_LHPMOUSE / 6 
MOV BUFFER[BX], CX 
MOV AH, F_IO CONTROL 
MOV AL, SF_SET LINKS 
MOV BP, V_SINPUT 
LEA SI, BUFFER 
PUSH DS 
POP ES 
PUSH DS 
CALL SYSCALL 
POP DS 


F INQUIRE (AH = 06H) 


we we we we we we we 


get the current mapping of the tablet — 
change tablet to HP Mouse 

save the new mapping 

load function code 

load subfunc. code 

load vector address 

get the offset of the buffer 


ES = DS 
save current DS 
call extended BIOS driver 


This function returns a pointer to the Physical Describe Record of the specified HP-HIL physical device 


driver. 


ne 


WARNING 


The Physical Describe Record should not be modified in any way. 
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On Entry: AH 
AL 
BP 


On Exit: AH 
ES:SI 


F_INQUIRE (06H) 
HP-HIL Device Number (1-7) 
V_SINPUT (O02AH ) 


Return Status Code 
Pointer to Physical Describe Record 


Registers Altered: AX, BP, SI, DS, ES 


F INQUIRE_ ALL (AH = 08H) 


This subfunction is used to determine which HP-HIL devices are present on the loop. The address of a 
seven-word table is passed to the subfunction. When the subfunction returns, the table will contain the 
current status of all HP-HIL devices. The format of the Device Inquire buffer is shown in Table 4-15. 
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Table 4-15. Device Inquire Buffer Format 


HP-HIL 
Device ID Device Status * 






HP-HIL Device 


Device #1 






* Bit 0 = 1 if device present, 0 if no device at this address. 
Bits 2 - 7 are reserved. 


On Entry: AH 
BP 
ES:SI 


F_INQUIRE ALL (08H) 
V_SINPUT (002AH ) 
Pointer to table 


On Exit: AH = Return Status Code 
ES:SI = Pointer to table 


Registers Altered: AX, BP, DS 
The following example shows how to use the F_INQUIRE_ ALL function. 
BUFFER DW 7 DUP (?) 

MOV AH, F_INQUIRE_ALL 


MOV BP, V_SINPUT 
LEA SI, BUFFER 


load function code 
load vector address 
get offset of buffer 


or we we 


PUSH DS 

POP ES ; ES = DS 

PUSH ODS 3 save current DS 
CALL SYSCALL ; call EX-BIOS driver 
POP DS 3; restore DS 


F__INQUIRE__ FIRST (AH = OAH) 


This function returns the vector address of the first HP-HIL physical device driver (HP-HIL address 1). 
This address allows the vector address of all HP-HIL physical device drivers to be easily calculated since 
the vectors are contiguous in the HP_VECTOR_ TABLE (see Table 4-16). 


On Entry: AH 
BP 


F_INQUIRE FIRST (OAH) 
V_SINPUT (002AH) 


On Exit: AH = Return Status Code 
BX = Vector address of first HP-HIL physical device driver 


Registers Altered: AX, BX, BP, DS 
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F REPORT __ENTRY (AH = OCH) 
This function is used to get the CS:IP of the physical GID driver. 


On Entry: AH F REPORT ENTRY (OCH) 


BP = V_SINPUT (002AH) 

On Exit: AH = Return Status Code 
BX = offset of physical GID driver 
ES = segment of physical GID driver 


Registers Altered: AX, BX, BP, DS, ES 


Physical GID Driver 

The physical GID driver is responsible for updating the Physical Describe Record. Two types of graphics 
input devices are defined in the input system, absolute (touchscreen and tablet), and relative (mouse). An 
instance of this driver (same code module, different data area) is installed for each graphic input device 
present. 


A summary of the PGID function codes is provided in Table 4-16. 


Table 4-16. Physical GID Driver Function Code Summary 


Function 
Equate Definition 


HP-HIL driver vector 1 through HP-HIL 
driver vector 7. Physical HP-HIL driver 
vectors (these vectors do not have fixed 
HP VECTOR_ TABLE addresses) 

F_ISR | Logical Interrupt 

F_ SYSTEM System functions 


SF_INIT | Initialize driver 


SF_ START Start driver 


SF_REPORT _ STATE Unsupported 


SF_VERSION _ DESC Report HP version number 
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Physical GID Driver Function Definitions 


F__ ISR (AH = OOH) 


This function processes ISR Event Records, updates the fields in its Physical Describe Record, and then 
calls its parent driver. HP-HIL devices Teport upward relative motion with a positive sign and downward 
relative motion with a negative sign. The industry standard representation is the opposite of this. 


On Entry: AH = F_ISR (00H) 
DH = Data Type 
DL = Physical device driver’s vector address /6 
BP = HP-HIL device n vector address 


For Button Event: 


BX = Button information. 


Bit Value Definition 

OFH-O8H - Reserved 

O7H 1 Button up 
0 Button down 


O6H-OOH Button number (0-7) 
For Motion Event: 


BX 
CX 


X axis motion in raw data form. 
Y axis motion in raw data form. 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. 


On Entry: AH 
AL 
BP 


F_ SYSTEM (02H) 
SF_INIT (00H) 
HP-HIL device n vector address 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__ START (AX = 0202H) 


This subfunction starts the driver. 
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On Entry: AH = F_SYSTEM (02H) 
AL = SF_START (02H) 
BP = HP-HIL device n vector address 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF__VERSION _ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960, and the BH register contains the week of the year. 


On Entry: AH F_SYSTEM (02H) 


AL = SF_VERSION DESC (06H) 
BP = HP-HIL device n vector address 
On Exit: AH = Return status code 
BX = Release date code 
CX = Number of byte in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


V__PNULL Driver (BP = O000OCH) 
The null device driver is the default event driver routine. It is used when the physical device is not 


recognized or the user event handler is not installed. It sets the AH register to RS_SUCCESSFUL and 
does an IRET. 


Hardware Interface Level Services 


Service drivers are provided as useful subroutines available to any driver. Currently the hardware 
interface level has only one service, the tracking sprite, V_ STRACK. 


V__STRACK Driver (BP = O0O5AH) 
V_ STRACK is called by the logical GID drivers to move the graphics cursor (sprite) on the display 
screen. V_ STRACK provides functions that allow the parameters of the sprite to be defined, and move 


the sprite around the display. 


A summary of the V_ STRACK function codes is provided in Table 4-17. 
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Table 4-17. V_STRACK Driver Function Code Summary 


Function Vector Function 
Equate Address Value 


V_ STRACK Sprite control 

F SYSTEM System functions 
SF_INIT Initialize driver 
SF_ START Start driver 


F TRACK _INIT Sets tracking to default 
state 


F TRACK_ON Enables tracking 


F TRACK OFF Disables tracking 


F DEF MASKS Define sprite masks 


F_SET_LIMITS_X Set max/min horizontal 
values 


F_SET_LIMITS_Y Set max/min vertical 
values 


F PUT_SPRITE Display sprite 


F REMOVE _ SPRITE Remove sprite from display 





V__STRACK Driver Function Definitions 


F__ISR (AH = OOH) 


This function is called to move the sprite to a new location. The display under the sprite is restored, and 
the sprite is redisplayed in its new location. The hot spot of the sprite is placed at the coordinates passed 


in BX and CX. 


On Entry: AH = F_ISR (00H) 
BX = X coordinate of sprite 
CX = Y coordinate of sprite 
DL = Source vector index 
BP = V_STRACK (00SAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol utilized in data space allocation ("last used DS" passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_INIT (OOH) 
BX = "Last used DS" in HP Data Area 
BP = V_STRACK (OOSAH ) 

On Exit: AH Return Status Code 


BX = New "last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF__ START (AX = 0202H) 
This subfunction is called to start the tracking driver. 
F SYSTEM (02H) 


SF_START (02H) 
V_STRACK (OOSAH) 


On Entry: AH 
AL 
BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F TRACK _INIT (AH = 04H) 


This function sets the tracking driver to its default state. It determines the current video mode and 
initializes the tracking parameters. 


On Entry: AH 
BP 


F_TRACK_INIT (04H) 
V_STRACK (OOSAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F TRACK__ON (AH = 06H) 
This function enables tracking. The sprite is displayed on the screen. 


F TRACK ON (06H) 


On Entry: AH = * 
V_STRACK (OOSAH ) 


BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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F TRACK _ OFF (AH = 08H) 
This function disables tracking. The sprite is removed from the screen. 


F_TRACK_OFF (08H) 


On Entry: AH = 
V_STRACK (QOSAH) 


BP 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F DEF_MASKS (AH = OAH) 


This function is called to define the sprite and screen masks used by the driver. If tracking is enabled, the 
sprite is erased and the new sprite is displayed in its place. The size of the sprite (its width in bytes 
multiplied by its height) is limited to a total of 144 bytes. The width of the save area is one byte greater 
than the width of the sprite. 


On Entry: AH = F_DEF MASKS (OAH) 


BH = Width of the save area (in bytes) 
BL = Hot Spot X coordinate 

CH = Height of sprite (in scan lines) 
CL = Hot Spot Y coordinate 

BP = V_STRACK (005AH) 


ES:SI = Pointer to sprite mask 
On Exit: AH = Return Status Code 
Registers Altered: AX, BP, DS 
The following example shows how to use the F_DEF_MASKS function provided by the tracking driver. 


SPRITE DW OFOFFH 1111700111111111 * marks 


DW OFOFFH 3 11110*#0011111111 the Hot 
DW OEO7FH ; 1110000001111111 Spot 
DW OEO7FH ; 1110000001111111 

DW OCO3FH ; 1100000000111111 

DW OCO3FH ; 1100000000111111 

DW O801FH ; 1000000000011111 

DW O801FH ; 1000000000011111 

DW OOOOFH ; 0000000000001111 

DW OOOOFH ; 0000000000001111 

DW OFOFFH ; 1111000011111111 

DW OFOFFH ; 1111000011111111 

DW OFOFFH ; 1111000011111111 

DW OFOFFH ; 1111000011111111 

DW OFOFFH 3; 1111000011111111 

DW OFOFFH 3; 1111000011111111 
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Define the XOR mask 


DW OOOO00H ; 0000000000000000 


% 
b 
DW OOO000H ; 0000000000000000 * marks 
DW OO600H ; 00000*1000000000 the Hot 
DW OOFOOH ; 0000111100000000 Spot 
DW OOFOOH ; 0000111100000000 . 
DW O1F80H ; 0001111110000000 
DW O1F80H ; 0001111110000000 
DW O3FCOH ; 0011111111000000 
DW O3FCOH ; 0011111111000000 
DW O7FEOH ; 0111111111100000 
DW OO600H ; 0000011000000000 
DW OO600H ; 0000011000000000 
DW OO600H ; 0000011000000000 
DW OO600H ; 00000110000006000 
DW OO600H ; 0000011000000000 
DW OO600H ; 0000011000000000 
5 


MOV AH, F_DEF MASKS ; load function code 


LEA SI, SPRITE 3; get the offset of the sprite 
PUSH DS 

POP ES ; ES = DS of sprite 

MOV CH, 10H ; height of sprite 

MOV BH, 3 ; number of bytes wide of the save area 
MOV BL, 5 ; hot spot x 

MOV CL, 1 3; hot spot y 

MOV BP, V_STRACK ; load vector address 

PUSH DS ; save current DS 

CALL SYSCALL ; call EX-BIOS DRIVER 

POP DS ; restore DS 


F SET_LIMITS_X (AH = OCH) 


This function sets the minimum and maximum horizontal position of the sprite on the screen. The default 
minimum and maximum values are the same as the current screen mode. 


On Entry: AH = F_SET LIMITS X (OCH) 
CX = Minimum X coordinate 
DX = Maximum X coordinate 
BP = V_STRACK (00SAH ) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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F_SET_LIMITS __Y (AH = OEH) 


This function sets the minimum and maximum vertical position of the sprite on the screen.. The default 
minimum and maximum values are the same as the current screen mode. 


On Entry: AH = F_SET LIMITS Y (OEH) 


CX = Minimum Y coordinate 
DX = Maximum Y coordinate 
BP = V_STRACK (OOSAH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F PUT_ SPRITE (AH = 10H) 
This function is called to put the sprite on the display. 


On Entry: AH = F_PUT SPRITE (10H) 


BX = X coordinate of sprite 
CX = Y coordinate of sprite 
BP = V_STRACK (O05AH) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


F REMOVE _ SPRITE (AH = 12H) 
This function removes the sprite from the display. 


On Entry: AH 
BP 


F_REMOVE SPRITE (12H) 
V_STRACK (O0SAH) 


On Exit: AH = Return Status Code. 


Registers Altered: AX, BP, DS 


4-70 | input System and HP-HIL 


V__SCANDOOR Driver (BP = 016EH) 


The V_SCANDOOR driver allows scancodes from the keyboard to be routed to the EX-BIOS before 
being sent to the 8042 data port (60H). A summary of the SCANDOOR driver function codes is 


provided in Table 4-18. 


Table 4-18. V_SCANDOOR Driver Function Code Summary 


Function 
Equate 





V_SCANDOOR 


F_ISR 


F_SYSTEM 

SF_INIT 

SF_START 
SF_VERSION_DESC 
F_STATE_IOCTL 


SF_GET_STATE 


V__SCANDOOR Driver Function Definitions 


F ISR (AH = 00H) 


SCANDOOR Driver 


Process SCANDOOR 
interrupt 


System function 

Initialize driver 

Driver start-up 

Reports HP version number 
STATE functions 


Get a STATE byte 


Vector Function 
Address Value 


016EH 


016EH 


016EH 


016EH 


016EH 


016EH 
016EH 


016EH 


This function is called by the V_S8259 driver to initiate processing of a hardware interrupt from the 


8042. 





CAUTION 


This function should not be called directly by an application program. 
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On Entry: AH 
BP 


F_ISR (00H) 
V_SCANDOOR (016EH) 


On Exit: AH 


Return status 


Registers Altered: AX, BP, DS 


SF__INIT (AX = 0200H) 


This subfunction initializes the driver. The driver will allocate and initialize local and global memory 
that belongs to it and prepare itself for start-up. 





CAUTION 


This function should not be called directly by an application program. 





On Entry: AH = F_SYSTEM (02H) 

AL = SF_INIT (OOH) 

BX = Last used DS 

BP = V_SCANDOOR (O16EH) 
On Exit: AH = Return status 

BS = New last used DS 


Registers Altered: AX, BX, BP, DS 


SF__ START (AX = 0202H) 


This subfunction starts the driver. 





CAUTION 


This function should not be called directly by an application program. 





On Entry: AH 
AL 
BP 


F SYSTEM (02H) 
SF_INIT (00H) 
V_SCANDOOR (016EH) 


tow a 


On Exit: AH Return status 


Registers Altered: AX, BP, DS 
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SF VERSION (AX = 


0206H) 


This subfunction will return the release code and a pointer to the current version number. 


On Entry: AH 
AL 
BP 


On Exit: AH 
BX 
CX 


ES: 


Registers Altered: AX, BX, BP, CX, DI, 


DI 


F_SYSTEM (02H) 
SF _VERSION_ DESC (06H ) 
Vu SCANDOOR (016EH) 


Return status 
Release code 


Number of bytes in version number 
Address of current version number string 


_— 


SF_GET__ STATE (AX = 0800H) 


This subfunction will return one of the STATE bytes maintained by the V_SCANDOOR driver. 
STATE byte number requested is passed to the driver in BL: 


On Entry: AH 


AL 
BL 
BP 
On Exit: AH 
BH 
State Byte 
0 
1 
2 
3 


F STATE_IOCTL (08H) 
SF_GET_STATE (00H) 
State byte number 

V_SCANDOOR (016EH) 


Return status 


STATE bits 

Bit Meaning 

0 Reserved 

1 Reserved 

2 SCAN DOOR OPEN 

3 SVC_DOOR_ OPEN 

0 BEEP ENABLE 

1 SPEED_ PARSE ENABLE 

2 CLICK _ ~ ENABLE 

3 CLICK PARSE_ENABLE 

0 SCANDOR STATE_INTS ON 
1 SCANDOR _ ~CERB_ INTS _ON 
2 SCANDOR SCAN “INTS ON 
3 SCANDOR_| —SVC_ INTS_ ON 
0 Reserved 

1 LOW CPU_SPEED 

2 Reserved 

3 Reserved 


Registers Altered: AX, BX, BP, DS 


(In the above, "CERB" refers to the HP-HIL controller.) 


BP, ES, DS 


input System and HP-HIL 


4- 


The 


73 


Keyboard 





Overview 
The Keyboard Input System for two keyboards are discussed in this chapter: 


w@ The HP Vectra Keyboard /DIN (shown in Figure 5-2) which is used with the HP Vectra ES series of 
personal computers. 


m= The HP Vectra Enhanced Keyboard (shown in Figure 5-3) which is used with the HP Vectra. series 
of personal computers. 


Information presented in this chapter will apply to both keyboards except when specified as 
Keyboard/DIN only (for the HP Vectra keyboard/DIN) or Enhanced keyboard only (for the HP 
Vectra Enhanced keyboard). 


The Keyboard Input System consists of four components: the input device drivers, STD-BIOS keyboard 
drivers, 8042 keyboard controller chip and the EX-BIOS keyboard drivers (see Figure 5-1). The input 
device drivers are discussed in Chapter 4. The other three components are discussed in this chapter. 


The industry standard INT 16H and INT 09H handlers make up the STD-BIOS keyboard drivers. INT 
16H is used by applications to get characters from the keyboard buffer. INT 09H responds to interrupts 
from the 8042 controller and places characters in the keyboard buffer. 


The 8042 controller chip provides an industry standard hardware interface to the INT 09H driver. It also 
provides timers and other services to the Input System. 


The EX-BIOS drivers allow applications to redefine the scancodes generated by certain groups of keys on 
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Figure 5-1. Keyboard Block Diagram 
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Keyboard Drivers 


The STD-BIOS component consists of two drivers: the keyboard ISR routine (INT 09H), and the keyboard 
interface driver (INT 16H). 


Overview 


The INT 09H driver responds to the 8042 OBF interrupt and reads in a scancode from the 8042 
controller. If the scancode is from one of the keyboard modifier keys, the appropriate state bits are 
updated. The scancode is then placed in the STD-BIOS keyboard buffer along with its corresponding 
ASCII character (keycode) or a null byte (OH). 


The INT 16H driver provides functions to allow the application to interrogate and manipulate the 
keyboard input system. Applications may check for keycodes in the STD-BIOS keyboard buffer, remove 
keycodes from it, retrieve the state of the keyboard modifiers, and put keycodes into the STD-BIOS 
keyboard buffer. Applications may also inquire about and/or change the typematic rate and delay values 
for the keyboard. 


Extended functions (supported with the ke ¥) are provided by the INT 16H driver to 
give the application additional control over the keyboard and to facilitate keyboard driver mapping. 
Extended functions allow the application to turn off or change the default translations performed on the 
HP Function keypads and Cursor Control keypads (see Figure 5-2). Functions are also provided to aid 
applications that install keypad translator services of their own. 





Data Structures 
The INT 16H and INT O9H driver data structures are located in the STD-BIOS data area. They are 


stored in memory addresses 417H (40:17H) through 43DH (40:3DH), 496H (40:96H) and 497H 
(40:97H). Table 5-1 lists these memory locations and their definitions. 
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Figure 5-2. HP Vectra Keyboard /DIN Keyboard Layout 
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Figure 5-3. HP Vectra Enhanced Keyboard Layout 
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00417H 
00419H 
0041AH 
0041CH 
0041EH 
00496H 


00497H 


Table 5-1. STD-BIOS Keyboard Driver Data Area 


Keyboard Flags 


Alt/Numpad accumulator 


Keyboard buffer head pointer 
Keyboard buffer tail pointer 
Keyboard buffer 

Extended keyboard flags 


Keyboard LED and data flags 





The keyboard buffer can store up to 16 entries. Each buffer entry consists of two bytes: an ASCII 
character (keycode) and a scancode. The keycode and the scancode are placed in the keyboard buffer by 
the INT 09H driver, and the keyboard head pointer is adjusted accordingly. They are retrieved from the 
buffer by the INT 16H driver, and the keyboard tail pointer is adjusted. 


The keyboard flags are maintained by the INT 09H driver. These flags indicate the state of the keyboard 
modifier keys and their respective modes. The byte at memory location 417H indicates the mode, the byte 
at 418H reflects the actual state of the keys themselves, the byte at 496H indicates the state of the 
extended keyboard processing, and the byte at 497H gives keyboard LED status and data received from 
the keyboard. Tables 5-2 through 5-5 list these flags and their meaning. 
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Table 5-2. Keyboard Shift Flags (Address 417H) 


<Ins> key state 
Insert mode is active 


<Caps lock> key state 
Caps lock mode is active 


<Num lock> key state 
Num lock mode is active 


<Scroll lock> key state 
Scroll lock mode is active 


<Alt> key state 
<Alt> key is pressed 








<Ctrl> key state 
<Ctrl> key is pressed 


Left <Shift> key state 
Left <Shift> key is pressed 


Right <Shift> key state 
Right <Shift> key pressed 


Table 5-3. Keyboard Secondary Shift Flags (Address 418H) 


<Ins> key state 
<Ins> key is pressed 


<Caps lock> key state 
<Caps lock> key is pressed 


<Num lock> key state 
<Num lock> key is pressed 


<Scroll lock> key state 
<Scroll lock> key is pressed 


Pause State 
Indicates the <Ctrl>-<Num lock> pause state is active 


<System request> key state 
<System request> key is pressed 


Left <Alt> key state 
Left <Alt> key is pressed 


Left <Ctrl> key state 
Left <Ctrl> key is pressed 
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Table 5-4. 101-key Keyboard Flags (Address 496H) 


ee 


Read ID bytes in progress 


First of ID bytes was last 


Force Num Lock if 101- an hen is attached. This is when 


Right <Alt> key status 
Right <Alt> key is pressed 


Right <Ctrl> key status 
Right <Ctrl> key is pressed 


EO was last 


E1 was last 





Table 5-5. Keyboard LED and Flags Data Area (Address 497H) 


Used for a flag to indicate 3 failures of sending data to keyboard 
LED update in progress 

Resend received from keyboard 

Acknowledge received from keyboard 

Reserved (set to 0) 


Caps Lock LED status 
Caps Lock LED on 


Num Lock LED status 
Num Lock LED on 


Scroll Lock LED status 
Scroll Lock LED on 





Note: Applications which modify these bytes may experience difficulty in maintaining synchronization 
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STD-BIOS Keyboard ISR (INT 09H) 


The keyboard interrupt service routine is responsible for retrieving scancodes from the 8042 controller, 
generating the associated keycodes, and placing them into the STD-BIOS keyboard buffer. Certain keys 
and key combinations do not generate a standard ASCII character code. In these cases a keycode equal to 
O indicates that an application program should examine the scancode byte to determine the "extended" 
ASCII code. Tables 5-6a through 5-6c contains the scancode to keycode translation assignments. 


TABLE 5-6a. ‘SCANCODE TRANSLATION TABLE 


Enhancd. Keybd/DIN 

keybd. keybd. 
Key Key AT HP Unshifted Shifted Ctrl Alt 
Number Number Scancode Scancode Key Cap ASCII Hex ASCII Hex 


110 90 76H 01H Esc esc 1BH esc 1BH ’1BH 00/01H 
02 02 16H 02H 1 1 31H { 21H - 00/78H 
03 03 1EH 03H 2 2 32H @ 40H 00H 00/79H 
04 04 26H 04H 3 3 33H 23H - 00/7AH 
05 05 25H 05H 4 4 34H $ 24H - 00/7BH 
06 06 2EH O6H 5 5 35H % 25H - 00/7CH 
-07 07 36H 07H 6 6 36H A 5EH 1EH 00/7DH 
08 08 3DH 08H 7 7 37H & 26H - 00/7EH 
09 09 3EH OSH 8 8 38H _ 2AH - 00/7FH 
10 10 46H OAH 9 9 39H ( 28H ~ 00/80H 
11 11 ' 45H OBH 0 0 30H ) 29H _- 00/81H 
12 12 4EH OCH - - 2DH ~ 5FH 1FH 00/82H 
13 13 55H ODH = = 3DH + 2BH - 00/83H 
15 15 66H OEH BkSp bs O8H bs 08H 7FH 00/0EH 
16 16 _ ODH OFH Tab tab OSH Nul 00H 00/94H 00/A5H 
17 17 15H 10H Q q 71H Q 51H 11H 00/10H 
18 18 1DH 11H WwW w 77H WwW 57H 17H 00/11H 
19 19 24H 12H E e 65H E 45H 05H 00/12H 
20 20 2DH 13H R r 72H R 52H 12H 00/13H 
21 21 2CH 14H T t 74H T 54H 14H 00/14H 
22 22 35H 15H Y y 79H Y 59H 19H 00/15H 
23 23 3CH 16H U u 75H U 55H 15H 00/16H 
24 24 43H 17H I i 69H 1 49H ‘09H 00/174 
25 25 44H 18H 1) ° 6FH oO 4FH OFH 00/18H 
26 26 4DH 19H P p 70H P 50H 10H 00/19H 
27 27 54H 1AH [ [ 5BH { 7BH 1BH 00/1AH 
28 28 5BH 1BH ] ] 5DH } 7DH 1DH 00/1BH 
43 43 5AH 1CH Enter cr ODH cr ODH OAH 00/1CH 
58 30 14H 1DH CTRL - - - ~ - - 
31 31 1CH 1EH A a 61H A 41H 01H 00/1EH 
32 32 1BH 1FH S s 73H Ss 53H 13H 00/1FH 
33 33 23H 20H D d 64H D 44H 04H 00/20H 
34 34 2BH 21H F f 66H F 46H O6H 00/21H 
35 35 34H 22H G g 67H G 47H 07H 00/22H 
36 36 33H 23H H h 68H H 48H 08H 00/23H 
37 37 3BH 24H J j 6AH J 4AH OAH 00/24H 
38 38 42H 25H K k 6BH K 4BH OBH 00/25H 
39 39 4BH 26H L H 6CH L 4CH OCH 00/26H 
40 40 4CH 27H ; : 3BH 3AH - 00/27H 
41 41 52H 28H : : 27H . 22H - 00/28H 
01 01 OEH 29H 60H ~ 7EH - 00/29H 
44 44 12H 2AH L Shift - - - - _ _ 
29 14 5DH 2BH \ \ 5CH | 7CH 1CH 00/2BH 
46 46 1AH 2CH Zz z 7AH Z 5AH 1AH 00/2CH 
47 47 22H 2DH xX x 78H x 58H 18H 00/2DH 
48 48 21H 2EH Cc c 63H Cc 43H 03H 00/2EH 
49 49 2AH 2FH Vv v 76H Vv 56H 16H 00/2FH 
50 50 32H 30H B b 62H B 42H 02H 00/30H 
51 51 31H 31H N n 6EH N 4EH OEH 00/31H 
52 52 3AH 32H M m 6DH M 4DH ODH 00/32H 
53 53 41H 33H : ; 2CH < ICH ~ 00/33H 
54 54 49H 34H 2EH > 3EH - 00/34H 
55 55 4AH 35H / 2FH ? 3FH ~ 00/35H 
57 57 59H 36H R Shift - ~ - - - - 
60 58 11H 38H Alt = - - ~ ~ - 
61 61 29H 39H Space sp 20H sp 20H 20H 20H 
30 64 58H 3AH Caps lock —- - - _ _ - 
(Cont.) 
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TABLE 5-6a. SCANCODE TRANSLATION TABLE (cont.) 


Enhanced. Keybd/DIN 

keybd. keybd. 

Key Key AT HP Unshifted 
Number Number Scancode Scancode ASClil Hex 


00/54H 00/SEH 
00/55H 00/5FH 
00/56H 00/60H 
00/57H 00/61H 
00/58H 00/62H 
00/59H 00/63H 
OO/SAH 00/64H 
00/5BH . 00/65H 
O00/5CH 00/66H 
00/5DH 00/67H 





Enhancd. Keybd/DIN 


keybd. keybd. NumLock None or 

Key Key AT HP or Shift NumLock 

Number Number Scancode Scancode Key Cap ASCli Hex and Shift CTRL Alt 

90 95 77H 45H Num Lock - 45H _- - - 

125 100 7EH 46H SerLck - 46H ~_ OO/OOH — 

91 91 6CH 47H Home 7 37H 00/47H O0/77H  — 

96 96 75H 48H 8 38H 00/48H 00/8DH -—- 

101 101 7DH 49H Pg Up 9 39H 00/49H 00/84H — 

105 107 7BH 4AH - - 2DH 2DH 00/8EH 00/4AH 
92 92 6BH 4BH 4 34H 00/4BH 00/73H — 

97 97 73H 4CH § 5 35H 00/4CH OO/BFH — 

102 102 74H 4DH 6 36H 00/4DH 00/74H  — 

106 108 79H 4EH + + 2BH 2BH 00/90H 00/4EH 
93 93 69H 4FH End 1 31H 00/4FH O0/75H — 

98 ; 98 72H 50H 2 32H 00/50H O0/91H —- 

103 103 7AH 51H Pg Dn 3 33H 00/51H OO/76H - 

99 99 70H 52H Ins 0 30H 00/52H 00/92H — 

104 104 71H 53H DEL : 2EH 00/53H 00/93H — 
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TABLE 5-6b. KEYBOARD/DIN KEYBOARD SPECIFIC KEYS 


Key AT HP 
Number Scancode Scancode Key Cap Unshifted Shifted CTRL 


* (NmPd) (Prt Sc) 00/72H 00/37H 
Sysreq - - 
— undef. 
— undef. 
— undef. 
— undef. 
— undef. 
— undef. 
— undef. 
— undef. 
— undef. 
Unlabeled-L 00/D7H 00/BDH 00/A3H 00/89H 
Unlabeled-R 00/D8H 00/BEH 00/A4H 00/8AH 
CCP-Up 00/D9H 00/BFH 00/A5H 00/8BH 
CCP-Lft 00/DAH 00/COH 00/A6H 00/8CH 
CCP-Dn 00/DBH 00/C1H 00/A7H 00/8DH 
CCP-Rht 00/DCH 00/C2H 00/A8H 00/8EH 
CCP-Home 00/DDH 00/C3H 00/ASH 00/8FH 
CCP-PgUp 00/DEH 00/C4H 00/AAH 00/90H 
CCP-End 00/DFH 00/C5H 00/ABH 00/91H 
CCP-PgDn 00/EO0H 00/C6H 00/ACH 00/92H 
CCP-Ins 00/E1H 00/C7H 00/ADH 00/983H 
CCP-Del 00/E2H 00/C8H 00/AEH 00/94H 
CCP-CNTR 00/E3H 00/C9H 00/AFH 00/95H 
~ undef. 00/E4H 00/CAH 00/BOH 00/96H 
— undef. 00/E5H 00/CBH 00/B1H 00/97H 
— undef. 00/E6H 00/CCH 00/B2H 00/98H 
~ undef. 00/E7H 00/CDH 00/B3H 00/99H 
— undef. 00/E8H 00/CEH 00/B4H 00/9AH 
70H f1 00/ESH 00/CFH 00/B5H 00/9BH 
71H f2 00/EAH 00/DOH 00/B6H 00/9CH 
72H 3 00/EBH 00/D1H 00/B7H 00/9DH 
73H £4 00/ECH 00/D2H 00/B8H 00/9EH 
74H {5 00/EDH 00/D3H 00/B9H 00/9FH 
75H 00/EEH 00/D4H 00/BAH 00/AOH 
76H {7 00/EFH 00/D5H 00/BBH 00/A1H 
77H 00/FOH 00/D6H 00/BCH 00/A2H 
78H 
through 
7FH 
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TABLE 5-6c. ENHANCED KEYBOARD SPECIFIC KEYS 


Key AT HP Key Unshifted Shifted . Alt 
Number Scancode Scancode Cap ASCII Hex ASCII Hex 


100 7CH 37H * (NmPq) 2AH 2AH 00/37H 
122 78H 57H Fit 00/85H 00/87H 00/8BH 
123 07H 58H Fi2 00/86H _ 00/88H 00/8CH 
124 EOH, 12H, 0H, 2AH, PrtSern - - 
wio Alt EOH,7CH ~~ £E0H, 37H (w/o Alt) 
124 84H 54H SysReq 
wi Alt (w/ Alt) 
126 E1H, 14H, 1H, 1DH, Pause 
w/oCntd 77H,E1H, 45H, E1H, (w/o Cntrl) 
FOH, 14H, 9DH, C5H 
FOH, 77H 
126 EOH, 7EH, OH, 46H, Break 
w/ Cntrl EOH, FOH, EOH, C6H (w/ Cntr\) 
7EH 


Duplicate Keys 


EOH, 14H  EOH,1DH R Cnt! - - - - 
EOH,5AH ~~ EOH, 1CH NmPd Ent 0D/EOH OD/EOH OA/EOH 00/A6H 
EOQH,4AH ~=-EOQH, 35H NmPd / 2F/EOH 2F/EOH 00/95H 00/A4H 
EOH, 11H EOH, 38H Rt Alt - - - - 
EOH, 12H, EOH, 2AH, Home E0/47H E0/47H E0/77H 00/97H 
(w/ NmLk) EOH, 6CH EOH, 47H (w/ NmLk) 
80 EOH,6CH, EOH,47H. Home E0/47H E0/47H 0/77H 00/97H 
(w/o NmLk) (w/o NmLk) 
89 EOH, 12H, EOH, 2AH, Left Arrow —- E0/4BH E0/4BH £0/73H 00/8BH 
(w/ NmLk) EOH,6BH OH, 4BH (w/ NmLk) 
89 EOH, 6BH, EOH, 4BH, Left Arrow — E0/4BH E0/4BH E0/73H 00/9BH 
(w/o NmLk) (w/o NmLk) 
81 EOH, 12H, QOH, 2AH, End E0/4FH EQ/4FH £0/75H 00/9FH 
(w/ NmLk) EOH,69H — EOH, 4FH (w/ NmLk) 
81 EOH, 69H, OH, 4FH, End - EO/4FH_ - EO/4FH £0/75H 00/9FH 
(w/o NmLk) (w/o NmLk) 
83 EOH, 12H, EOH, 2AH, Up Arrow - E0/48H E0/48H E0/8DH 00/98H 
(w/ NmLk) EOH, 75H EOH, 48H (w/ NmLk) 
83 EOH, 75H, —EOH, 48H, Up Arrow - E0/48H E0/48H E0/8DH 00/98H 
(w/o NmLk) (w/o NmLk) 
84 —EOH, 12H, EOH, 2AH, Dwn Arrow. - EO/SOH_ - E0/S50H £0/91H 00/AOH 
(w/ NmLk) EOH, 72H EOH, 50H (w/ NmLk) 
84 EOH, 72H, EQOH, 50H, Dwn Arrow - E0/50H E0/50H E0/91H 00/AOH 
(w/o Nmvk) (w/o NmLk) 
75 EOH, 12H, EOH, 2AH, Insert - E0/52H E0/52H E0/92H 00/A2H 
(w/ NmLk) EOH,70H  EOH, 52H (w/ NmLk) 
75 EOH, 70H, EOH, 52H, Insert - E0/52H E0/52H §0/92H 00/A2H 
(w/o NmLk) (w/o NmLk) 
85 EOH, 12H, OH, 2AH, Page Up 7 E0/49H E0/49H E0/84H 00/99H 
(w/NmLk) EOH,7DH —EOH, 49H (w/ NmLk) , 
85 EOH, 7DH, EQH, 49H, Page Up - E0/49H E0/49H E0/84H 00/99H 
(w/o NmLk) (w/o NmLk) 
89 EOH, 12H, OH, 2AH, Right Arrow - E0/4DH EQ/4DH_ £0/74H 00/9DH 
(w/ NmLk) £OH,74H ~~ EOH, 4DH (w/ NmLk) 
89 EOH, 74H, OH, 4DH, Right Arrow - EO/4ADH_~ - E0/4DH_ 0/74H 00/9DH 
(w/o NmLk) (w/o NmLk) 
86 EOH, 12H, OH, 2AH, Page Dwn_ - EO/S1H_~ - E0/51H §0/76H 00/A1H 
(w/NmLk) EOH,7AH  EO0H,51H (w/ NmLk) 
86 EOH, 7AH, OH, 51H, Page Dwn_ - E0/51H E0/51H §0/76H 00/A1H 
(w/o NmLk) (w/o NmLk) 
76 EOH, 12H, OH, 2AH, Delete E0/53H E0/53H £0/93H 00/A3H 
(w/NmLk) EOH,71H OH, 53H (w/ NmLk) 
76 EOH, 71H, EOH, 53H, Delete - E0/53H_- E0/53H £0/93H 00/A3H 
(w/o NmLk) (w/o NmLk) 


Hidden Keys 


6AH 7 ca 

SDH 1C/2BH 00/2BH 
61H 7C/S56H 7C/S6H 
S1H - - 

- 00/A3H 00/8SH 
- 00/A4H 

68H 

6DH 

63H 
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The INT 09H driver tracks the state of the keyboard modifiers presented in Tables 5-2 through 5-5 as 
well as processing the special key sequences in Table 5-7. 


Table 5-7. INT 09H Special Key Sequences 


<Pause> Stops execution until any non-shift key on the keyboard is 
struck. 





<Ctrl>-<Num lock> Stops execution until any non-shift key on the keyboard 1s 
struck. 


<Ctrl>-<Alt>-<+> This key sequence enables the key click feature. The longer 
the these keys are held down together, the louder the key 
click. After maximum volume is achieved the key click 
volume will wrap around to low volume. This is done in the 
8042 


<Ctrl>-<Alt>-<-> | This key sequence reduces the key click volume until it is off. 
This is done in the 8042. 


<Ctrl>-<Alt>-< > This key sequence toggles the computer speed. (On the Vectra 
ES, this is handled by the 8042. On the Vectra RS this is 
handled by the system BIOS.) 


<Ctrl>-<Break> This key sequence is interpreted as a program break request. 
When this key sequence is detected, the INT 09H driver will 
execute an INT 1BH instruction. The vector for this interrupt 
is initialized during the boot process to point to a routine 
within MS-DOS which sets a flag then performs an IRET in- 
struction. This vector may be modified to point to an alternate 
routine to handle a <Ctrl>-<Break>. 


<Ctrl>-<Alt>-<DEL> This key sequence is interpreted as a system reset command. 
When this key sequence is detected, control is transferred to 
the BIOS Reset routine. 


<Print Screen> This key is interpreted as a print screen command. When this 
key is detected, an INT 05H instruction is executed. 





<Shift>-<Print Screen> This key sequence is interpreted as a print screen command. 
When this key sequence is detected, an INT 05H instruction 1s 
executed. 


<System request> This key is interpreted as a system request for multi-tasking. 
<Alt>-nnn Where nnn represents a three digit decimal number entered on 


the numeric keypad which yields the associated ASCII charac- 
ters, i.e., <Alt>-122 yields the character "z". 
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STD-BIOS Keyboard Driver (INT 16H) 


The INT 16H driver acts as the interface between applications and the keyboard. This driver has two sets 
of functions. One set provides functions to return keycodes and keyboard status. The other set of 
functions allows the appheshons to Sha iio ne Jandlauen sleorithins of the scancodes and to vary the 





codes. 


Table 5-8. Keyboard Driver (INT 16H) Function Code Summary 


Function Function Hex 
Equate Definition Value 


INT_KBD Keyboard 











F16_GET_KEY Read keycode from keyboard buffer 








Report Status of keyboard buffer 





F16_ STATUS 











Get Key Modifier Status 





F16_ KEY STATE 









F16_ SET 
_TYPE_RATE 


Set typematic rates 










F16_PUT_KEY Put data into keyboard buffer 





F1i6_GET_EXT_KEY Read keycode from buffer (Vectra ES and 


RS keycodes) 






F16_EXT_STATUS © Report keyboard status (including new 


Vectra ES and RS keycodes) 










F16_ EXT 
_KEY_ STATE 


Get extended key modifier status 






EX-BIOS present 





F16_ INQUIRE 









Fi16_ DEF ATTR Report default values for repeat rates and 


delay time t before i 












F16_GET_ATTR 









F16 SET _ATTR 





Replaces current repeat rates and delay 
time Keyboard/DIN only 










F16 DEF MAPPING 





Reports default HP-system vector entries 
for keyboard translator drivers 
Keyboard/DIN only | 
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Table 5-8. Keyboard Driver (INT 16H) Function Code Summary (Cont.) 


F16_ GET _MAPPING 
F16_ SET _MAPPING 


F16_ SET _XLATORS 


F16 KBD 
F16_KBD_RESET 


F16_ READ SPEED 


F16 SET _LOW 
__ SPEED 


F16 SET HIGH 
_SPEED 


F16_GET_INT 
__NUMBER 


Reports current HP-system vector entries 
for keyboard translator drivers 


Replaces current HP-system vector entries 
for keyboard translator drivers 
Keyboard/DIN only 

Switches either the cursor controlpad trans- 
lator or the HP Function keypad translator 
functions of the keyboard 

Keyboard/DIN only 


Reports keyboard identification 
Keyboard/DIN only 


Reset logical keyboard structure to defaults 
Keyboard/DIN only 


Read current speed 


Selects the low speed for the computer 


Selects the high speed for the computer 


Returns the current HPENTRY interrupt 
number 
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Keyboard Driver (INT 16H) Function Definitions 


Fi6_ GET_KEY (AH = 00H) 


This function returns the next keycode from the keyboard buffer. If no keycode is ready, this function 
waits for one. This function does not return all keycodes available on the HP Vectra ES and RS series 
computers. It returns those keycodes that are available on the original HP Vectra PC. The new keycodes 
are thrown away. 


On Entry: AH = F16_GET_KEY (00H) 


On Exit: AH 
AL 


Scancode 
ASCII keycode or extended keycode 


Registers Altered: AX 


F16 STATUS (AH = 01H) 


This function returns the status of the keyboard buffer. The Zero flag is cleared if a keycode is available, 
or set if there is no keycode in the buffer. If a keycode is ready, the scancode and keycode are returned 
in the AH and AL registers respectively. Even though the scancode and keycode are returned with this 
function, they must be read with F16__GET_KEY to remove them from the keyboard buffer. This 
function does not return all keycodes available on the HP Vectra ES and RS series of computers. It 
returns those keycodes that are available on the original HP Vectra PC. The new keycodes are thrown 
away. 


On Entry: AH 


F16 STATUS (01H) 


On Exit: Z 
Zz 


if no keycode is ready. 
if a keycode is ready. 


o—_— 


and 


s 


AH = Scancode 
AL = Keycode or extended keycode. 


Registers Altered: AX 
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The INT O9H driver tracks the state of the keyboard modifiers presented in Tables 5-2 through 5-5 as 
well as processing the special key sequences in Table 5-7. 


Table 5-7. INT 09H Special Key Sequences 


Stops execution until any non-shift key on the keyboard 1s 





<Ctrl>-<Num lock> Stops execution until any non-shift key on the keyboard is 
struck. =. 
Keyboard/DIN 





<Ctrl>-<Alt>-<+> This key sequence enables the key click feature. The longer 
the these keys are held down together, the louder the key 
click. After maximum volume is achieved the key click 
volume will wrap around to low volume. This is done in the 
8042 


<Ctrl>-<Alt>-<-> This key sequence reduces the key click volume until it is off. 
This is done in the 8042. 


<Ctrl>-<Alt>-<\> This key sequence toggles the computer speed. (On the Vectra 
ES, this is handled by the 8042. On the Vectra QS and RS this 
is handled by the system BIOS.) 


<Ctrl>-<Break> This key sequence is interpreted as a program break request. 
When this key sequence is detected, the INT 09H driver will 
execute an INT 1BH instruction. The vector for this interrupt 
is initialized during the boot process to point to a routine 
within MS-DOS which sets a flag then performs an IRET in- 
struction. This vector may be modified to point to an alternate 
routine to handle a <Ctrl>-<Break>. 


<Ctrl>-<Alt>-<DEL> This key sequence is interpreted as a system reset command. 
When this key sequence is detected, control is transferred to 
the BIOS Reset routine. 


<Print Screen> This key is interpreted as a print screen command. When this 
key is detected, an INT 05H instruction is executed. 





<Shift>-<Print Screen> This key sequence is interpreted as a print screen command. 
When this key sequence is detected, an INT O5H instruction is 
executed. 


Keyboa 





<System request> This key is interpreted as a system request for multi-tasking. 


<Alt>-nnn Where nnn represents a three digit decimal number entered on 
the numeric keypad which yields the associated ASCII charac- 
ters, i.e., <Alt>-122 yields the character "z". 
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STD-BIOS Keyboard Driver (INT 16H) 


The INT 16H driver acts as the interface between applications and the keyboard. This driver has two sets 
of functions. One set provides functions to return keycodes and keyboard status. The other set of 
functions allows the application to change the translation algorithms of the scancodes and to vary the 
repeat rates of the keys on the Keyboard/DIN only. Table 5-8 is a summary of this driver’s function 


codes. 


Table 5-8. Keyboard Driver (INT 16H) Function Code Summary 


Function 
Equate 


INT_KBD 






F16_GET_KEY 






F16_ STATUS 






F16_KEY_ STATE 







F16_ SET 
_TYPE_RATE 






F16_PUT_KEY 






F16_GET_EXT_KEY 





F16_EXT_STATUS 








F16_ EXT 
_KEY_ STATE 






F16_ INQUIRE 






F16_DEF_ATTR 





F16_GET_ATTR 





F16_ SET ATTR 






F16_ DEF MAPPING 
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Keyboard 


Function 
Definition 


Keyboard 

Read keycode from keyboard buffer 
Report Status of keyboard buffer 
Get Key Modifier Status 


Set typematic rates 


Put data into keyboard buffer 


Read keycode from buffer (including new 
Vectra ES, QS, and RS keycodes) 


Report keyboard status (including new 
Vectra ES, QS, and RS keycodes) 


Get extended key modifier status 


EX-BIOS present 


Report default values for repeat rates and 
delay time before repeat 
Keyboard/DI ly 








Report current repeat rates and delay time 


Keyboard/DIN only 


Reports default HP-system vector entries 
for keyboard translator drivers 
Keyboard/DIN only | 





Table 5-8. Keyboard Driver (INT 16H) Function Code Summary (Cont.) 


Function Function Hex 
Equate Definition Value 
F16 GET MAPPING Reports current HP-system vector entries 


for keyboard translator drivers 


F16 SET MAPPING Replaces current HP-system vector entries 
for eyoare translator drivers 


F16 SET XLATORS Switches either the cursor controlpad trans- 
lator or the HP Function keypad translator 
functions of the keyboard 


F16 KBD Repos keyboard identifi ication 


F16_ KBD RESET Reset logical keyboard structure to defaults 


F16 READ SPEED Read current speed 


F16 SET LOW Selects the low speed for the computer 
_ SPEED 


F16_ SET HIGH Selects the high speed for the computer 
_ SPEED 


F16_GET_INT Returns the current HPENTRY interrupt 
__NUMBER number 
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Keyboard Driver (INT 16H) Function Definitions 


F16_ GET KEY (AH = OOH) 


This function returns the next keycode from the keyboard buffer. If no keycode is ready, this function 
waits for one. This function does not return all keycodes available on the HP Vectra series of computers. 
It returns those keycodes that are available on the original HP Vectra PC. The new keycodes are thrown 
away. . 


On Entry: AH = F16 GET_KEY (00H) 


On Exit: AH 
AL 


Scancode 
ASCII keycode or extended keycode 


Registers Altered: AX 


F16_ STATUS (AH = 01H) 


This function returns the status of the keyboard buffer. The Zero flag is cleared if a keycode is available 
or set if there is no keycode in the buffer. If a keycode is ready, the scancode and keycode are returned 
in the AH and AL registers respectively. Even though the scancode and Keycode are returned with this 
function, they must be read with F 16__GET_KEY to remove them from the keyboard buffer. This 
function does not return all keycodes available on the HP Vectra series of computers. It returns those 
keycodes that are available on the original HP Vectra PC. The new keycodes are thrown away. 


> 


On Entry: AH = F16 STATUS (01H) 


On Exit: Z = 1 if no keycode is ready. 
Z = 0 if a keycode is ready. 
and 
AH = Scancode 
AL = Keycode or extended keycode. 


Registers Altered: AX 


5-16 Keyboard 


F116 KEY STATE (AH = 02H) 


This function returns the state of the various keyboard modifiers that were availble on the original HP 
Vectra PC. The status byte returned is a copy of the keyboard modifier status byte stored at memory 


location 417H. 


On Entry: AH = F16 KEY STATE (02H) 


On Exit: AL = Modifier Status Byte 


Bit Data 
O7H 1 
0 
O6H 1 
0 
OSH 1 
0 
04H 1 
0 
03H 1 
0 
02H 1 
0 
O1H 1 
0 
OOH 1 
0 


Registers Altered: 


Definition 


Insert mode active 
Insert mode inactive 
Caps lock mode active 
Caps lock mode inactive 
Num lock mode active 
Num lock mode inactive 


~Seroll lock mode active 


Scroll lock mode inactive 
<Alt> key pressed 

<Alt> key released 

<Ctrl> key pressed 

<Ctrl> key released 

Left <Shift> key pressed 
Left <Shift> key released 
Right <Shift> key pressed 
Right <Shift> key released 


Fi6. SET_TYPE_RATE (AH = 03H) 


This command sets the values for the typematic rate and delay. The typematic rate is the number of 
make scancodes per second sent in the typematic (repeat) mode. The delay is the amount of time a key 
must be held down until it enters the typematic mode. 


On Entry: AH 
AL 
BH 
BL 


05 


On Exit: None 


Registers Altered: AX 


F16 SET TYPE_RATE (03H) 


Typematic Delay (00-03H) 
Typematic Rate (00-1FH) 
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Fi6_ PUT_KEY (AH = 05H) 


This command puts a scancode and a keycode in the keyboard buffer. When this is done, it looks just 
like INT 9 placed the scancode and keycode there. It may be read with INT 16 functions 0, 1, 10 and 
11. 


On Entry: AH 
CX 


Fi6 PUT_KEY (05H) 

Data to place in keyboard buffer 
CH Scancode 

CL Keycode or extended keycode 


On Exit: AL = 00 if store successful AL = 01 if not 


Registers Altered: AX 


F16,= GET EXT_ KEY (AH = 10H) 


This function returns the next keycode fromthe keyboard buffer. If no keycode is ready, this function 
waits for one. All keycodes are returned; none are thrown away 


On Entry: AH = F_16 GET_EXT_KEY (10H) 


On Exit: AH 
AL 


Scancode 
Keycode or extended keycode 


"ott 


Registers Altered: AX 


F116, EXT__ STATUS (AH = 11H) 


This function returns the status of the keyboard buffer. The Zero flag is cleared if a keycode is available, 
or set if there is no keycode in the buffer. If a keycode is ready, the scacode and keycode are returned in 
the AH and AL registers respectively. Enen though the scancode and keycode are returned with this 
function, they must be read with F16_GET_EXT__KEY to remove them from the keyboard buffer. All 
keycodes are returned; none are thrown away. 


On Entry: AH F16 EXT STATUS (11H) 


On Exit: AH Scancode 

Keycode or extended keycode 
Z = 1 if no keycode is ready 
Z = 0 if a keycode is ready 


> 
ae 
tot 


Registers Altered: AX, flag 
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F116) EXT _KEY_ STATE (AH = 12H) 


This function returns the state of various keyboard modifiers, including the new states available on the 
HP Vectra series of computers. AL is a copy of the keyboard modifier status byte stored at memory 
location 417H. AH is a combination of some of the bits stored in memory location 418H and 496H. 


On Entry: AH = F16 EXT KEY STATE (12H) 


On Exit: AH Extended Modifier Status 


AL Modifier Status Byte 
AL: Bit Data Definition 

O7H 1 Insert mode active 
0 Insert mode inactive 

O6H 1 Caps lock mode active 
0 Caps lock mode inactive 

05H 1 Num lock mode active 
0 Num lock mode inactive 

04H 1 Scroll lock mode active 
0 Scroll lock mode inactive 

03H 1 <Alt> key pressed 
0 <Alt> key released 

02H 1 <Ctrl> key pressed 
0 <Ctrl> key released 

O1H 1 Left <Shift> key pressed 
0 Left <Shift> key released 

OOH 1 Right <Shift> key pressed 
0 Right <Shift> key released 

AH: Bit Data Definition Concatenated From 

O7H 1 <System request> key pressed bit 2 418H 
0 <System request> key released 

O6H 1 <Caps lock> key pressed bit 6 418H 
0 <Caps lock> key released 

OSH 1 <Num lock> key pressed bit 5 418H 
0 <Num lock> key released 

04H 1 <Scroll lock> key pressed bit 4 418H 
0 <Scroll lock> key released 

03H 1 Right <Alt> key pressed bit 3 496H 
0 Right <Alt> key released 

O2H 1 Right <Ctrl> key pressed bit 2 496H 
0 Right <Ctrl> key released 

O1H 1 Left <Alt> key pressed bit 1 418H 
0 Left <Alt> key released 

OOH 1 Left <Ctrl> key pressed bit O 418H 
0 Left <Ctrl> key released 


Registers Altered: AX 
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Fi6é__ INQUIRE (AX = 6FOOH) 


This subfunction determines whether or not the extended HP functions are available. If the HP functions 
are available, the BX register will be set to 4850H (which is the ASCII characters ’HP’). 


On Entry: AX 
BX 


F16 INQUIRE (6FOOH) 
Any value except 4850H, “’HP’. 


On Exit: BX = ‘HP’ 


Registers Altered: BX 


Fi6é_ DEF_ATTR (AX = 6FO1H) 





This subfunction reports the default typematic rate and delay values for the keyboard. A pointer toa 
four-byte buffer is returned, but the last 2 bytes in that buffer are ignored. The bytes in the buffer are 
defined in Table 5-9. 


Table 5-9. INT 16H Typematic Buffer Format 


Function 


Delay before repeat action starts for all keys. 


Typematic Repeat rate for all keys. 





Table 5-10 summarizes the typematic rate and delay values defined for each data byte accepted in the 
typematic buffer by the INT 16H driver. 


Table 5-10. INT 16H Typematic Rates and Delays 










Byte 0 
Number of Milli- 
















Data Byte seconds Delayed * * 
0OH (30.00) [0.250] 
01H (30.00) [0.250] 
02H (20.00) [0.250] 
03H (15.00) [0.250] 
04H (12.00) [0.250] 
OSH (10.00) [0.250] 
06H (9.20) [0.250] 
07H (7.50) [0.500] 
08H (6.70) [0.500] 
09H (6.00) [0.500] 
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Table 5-10. INT 16H Typematic Rates and Delays (Cont.) 


Byte 0 
Number of Milli- 
Data Byte seconds Delayed * * 


[0.500] 
[0.750] 
[0.750] 
[0.750] 
[0.750] 
[0.750] 





* Numbers in parentheses () indicate the approximate number of repeated characters per 
second. 
a Numbers in brackets [] indicate the approximate length of delay prior to the first 


repeated scancode report. 


On Entry: AX = F16 DEF _ATTR (6FO1H) 


On Exit: AH = OOH (Successful operation) 
ES:SI = Pointer to buffer 
CX = 4 (Number of entries in table) 


Registers Altered: AX, CX, SI, ES 


F116) GET_ATTR (AX = 6FO02H) 

This subfunction reports the current typematic rate and delay values for the keyboard. A pointer to a 
four-byte buffer is returned, but the last two bytes are ignored. The bytes in the buffer are interpreted 
as shown in Table 5-9 and 5-10. 

On Entry: AX = F16 GET_ATTR (6F02H) 

On Exit: AH 


ES:SI 
CX 


OOH (Successful operation) 
Pointer to buffer 
4 (Number of entries in table) 


Registers Altered: AX, CX, SI, ES 
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F16_= SET_ATTR (AX = 6F03H) 


This subfunction sets the current typematic rate and delay values for the keyboard. A pointer to a 
two-byte buffer is passed, but the second byte is ignored. The bytes in the buffer are interpreted as 
shown in Table 5-9 and 5-10. Note that the values passed for the rest of the keyboard are also applied 
to the Cursor Control keypad. 


On Entry: AX 
ES:SI 


F16 SET _ATTR (6F03H) 
Pointer to buffer 


On Exit: AH = OOH (Successful operation) 


Registers Altered: AX 


Fi6é_DEF__MAPPING (AX = 6F0O4H) 





This subfunction reports the default keyboard translator mappings. A pointer to a buffer of 1EH bytes is 
supplied by the caller to be filled in by the ROM-BIOS. The table will contain the default 
HP_VECTOR_ TABLE entries for each of the five translator drivers. Each of five entries in the table 
will contain the IP, CS, and DS for each translator driver. 


CAUTION 


An application should restore the translator drivers to their original 
condition upon termination. If an application replaces one of these drivers, 
the programmer should be aware that the EX-BIOS keyboard driver 
functions 6FO7H may no longer function properly. 


The format of the buffer is given in Table 5-11. 


Table 5-11. INT 16H Mapping Buffer Format 


00H Entry for V_ QWERTY driver 
Entry for V_SOFTKEY driver 
Entry for V_ FUNCTION driver 
Entry for V_ NUMPAD driver 
Entry for V_CCP driver 









In the above table, note that QWERTY refers to the typewriter keypad, SOFTKEY refers to the HP 
Function keypad, FUNCTION refers to the Compatibility Function keypad, NUMPAD refers to the 
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Numeric keypad, CCP refers to the Cursor Control keypad (the location of keypads on the 
Keyboard /DIN are shown in Figure 5-2.) . 


On Entry: AX = F16 DEF MAPPING (6F04H) 
ES:SI = Pointer to buffer 


OOH (Successful) 
Pointer to buffer of 1EH bytes 
1EH (Size of buffer) 


On Exit: AH 
ES:SI 
CX 


hou ou 


Registers Altered: AX, CX 


F16__GET__MAPPING (AX = 6FO5H) 
Keyboard/DIN only 


This subfunction reports the current keyboard translator mappings. A pointer to a buffer 1EH bytes in 
length is supplied by the caller to be filled in by the ROM-BIOS. The buffer wiil contain the current 
HP _VECTOR_ TABLE entries for each of the five translator drivers (IP, CS, and DS for each driver). 
The format of the buffer is given in Table 5-11. 


On Entry: AX 
ES:SI 


F16 GET MAPPING (6FO5H) 
Pointer to buffer 


th ott 


OOH (Successful) 
Pointer to buffer 
1EH (Size of table) 


On Exit: AH 
ES:SI 
CX 


Registers Altered: AX, CX 


F16 SET MAPPING (AX = 6FO6H) 
Keyboard/DIN only 


This subfunction sets the current keyboard translator mappings. A pointer to a buffer containing the 
entries to be written into the HP_ VECTOR TABLE is passed in. The format of the buffer is given in 
Table 5-11. 


A driver that replaces a scancode translator can expect to handle a Keyboard ISR Event Record (Table 
5-13). If the translator wishes to remove the passed in scancode trom the scancode stream, it returns a 
status of RS DONE. Otherwise, a return status of RS SUCCESSFUL should be set and an appropriate 
ISR EVENT record returned. The ISR Event Record will then be passed on to the next driver in the 
chain. The driver can depend on 29H bytes of stack. 


On Entry: AX 
ES:SI 
CX 


F1i6 SET MAPPING (6FO6H) 
Pointer to table. 
O1EH (size of table in bytes) 


tod 


On Exit: AH = OOH (Successful) 


Registers Altered: AX 
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F16. SET XLATORS (AX = 6F07H) 





This subfunction sets the current mappings of the HP Function keypad (V_SOFTKEY) and Cursor 
Control keypad (V_CCP) translators. Note that only one translator may be set with each call to this 
subfunction. (Figure 5-2 shows the possible mappings for these two HP proprietary keypads.) 


On Entry: AX = F16_ SET XLATORS (6FO7H) 
BL = Translation 
Data Definition 
OOH Maps V_CCP to V_CCPCUR which forces the Cursor Control key pad 


to generate Numeric keypad cursor key scancodes, regardless of 
state of <Num lock>. (Default mapping) 


O1H Maps V_CCP to V_CCPNUM which forces the Cursor Control keypad to 
generate Numeric keypad or cursor key scancodes, depending on 
state of <Num lock>. 


02H Maps V_CCP to V_OFF which disables the Cursor Control keypad. 


03H Maps V_CCP to V_CCPGID (if installed) which converts Cursor 
Control keypad data to GID data. 


04H | Maps V_CCP to V_RAW which passes Cursor Control keypad scancodes 
untranslated to the INT O9H driver. 


OSH Maps V_SOFTKEY to V_SKEY2FKEY which translates HP Function 
key pad “gcancodes into equivalent industry standard Compatibility 
Function keypad scancodes (default mapping). 


O6H Maps V_SOFTKEY to V_RAW which passes HP Function keypad 
scancodes untranslated to INT OSH driver. 


O7H Maps V_SOFTKEY to V_OFF which disables HP Function keypad. 


On Exit: AH = 00 (Successful) 


Registers Altered: AX 
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F16_ KBD (AX = 6FO8H) 


This subfunction returns the ID of the keyboard. 


On Entry: AX = F16 KBD (6F08H) 


On Exit: AH = OOH (Successful) 


or 02H (Unsupported) if a non-HP keyboard is attached 
BL = Language of the attached keyboard (see below) 


Registers Altered: AX, BX 


Keyboard Identification: 


Register BL Language 
00 Reserved 
01 Arabic-French 
02 . Kanji 
03 Swiss-French 
04 Portugese 
05 Arabic 
06 Hebrew 
07 Canadian-English 
08 Turkish 
09 Greek 
OA Thai 
OB Italian 
oc Hangul (Korean) 
OD Dutch 
OE Swedish 
OF German 


Register BL 


Language 


Chinese (PRC) 

Chinese (Taiwan) 

Swiss (French ii) 
Spanish 

Swiss (German ii) 
Belgian (Flemish) 
Finish 

United Kingdom 
French-Canadian 
French-German 
Norwegian 

French 

Danish 

Katakana 

Latin American Spanish 
United States-American 


OFFH non-HP keyboard (IBM AT keyboard and IBM Enhanced keyboard) 


All others are reserved. 


F16_KBD__RESET (AX = 6FO9H) 





This subfunction resets all keyboard mappings to their default translators and resets all keyboard 
typematic rates and delays to their default values. 


On Entry: AX = F16_KBD RESET (6F09H) 


On Exit: AH = OOH (Successful) 


Registers Altered: AX 
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F16_ READ_ SPEED (AX = 6FOAH) 


This subfunction returns a code for the current speed of the compute: Computer speeds for the Vectra 
series of computers are shown in Table 5-12. 


On Entry: AX = F16 READ SPEED (6FOAH) 
On Exit: AH = OOH (Successful) 
BX = OBH for low speed (see following table) 


12H for medium speed (see following table) 
OCH for high speed (see following table) 


Registers Altered: AX, BX 


Table 5-12. Speeds for HP Vectra Series of Computers 


ee 


are 
QS/16, RS/16 
QS/20, RS/20 


RS/20C 10 MHz 
RS/25C 12.5 MHz 





F16_ SET LOW _ SPEED (AX = 6FOBH) 
This subfunction sets the speed of the computer to low. 
On Entry: AX = F16 SET LOW SPEED (6FOBH) 

On Exit: AH = OOH (Successful) 


Registers Altered: AX 


F116. SET HIGH _ SPEED (AX = 6FOCH) 
This subfunction sets the speed of the computer to high. 
On Entry: AX = F16 SET HIGH SPEED (6FOCH) 

On Exit: AH = OOH (Successful) 


Registers Altered: AX 
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Fi6é. GET INT NUMBER (AX = 6FODH) 


In the original HP Vectra PC, the HPENTRY vector is INT 6FH. On the HP Vectra series of computers, 
the default vector is INT 6FH, but it can be moved to another interrupt by the system. If an application 
programmer wants to use the HPENTRY interrupt, they should do an INT 16 6FODH function to get the 
interrupt number in use. 


On Entry: AX 
On Exit: AH 


F16_GET_INT NUMBER (6FODH) 

Interrupt Number (except when AH = 2, then the 
interrupt number is 6FH) 

Registers Altered: AX 


F16_ SET. CACHE___ON (AX = 6FOFH) -- This subfunction enables memory caching. 
On Entry: AX = F16 SET CACHE_ON (6FOFH) 

On Exit: AH = OOH (Successful) 

= FEH (Cache subsystem is bad) 

Registers Altered: AX 


F16_ SET CACHE ___ OFF (AX = 6F10H) -- This subfunction disables memory caching. 
On Entry: AX = F16_ SET CACHE OFF (AX = 6F10H) 

On Exit: AH = OOH (Successful) 

Registers Altered: AX 


F16_ GET CACHE __ STATE (AX = 6F11H) 
This subfunction returns the memory cache subsystem’s state. 
On Entry: AX = F16_ GET CACHE STATE (AX = 6F11H) 
On Exit: | AH = OOH (Successful) 
AL bit 0 = 0 (Cache Disabled) 
= {| (Cache Enabled) 
Registers Altered: AX 


F16__ SET = MEDIUM___SPEED (AX = 6F 12H) 

This subfunction sets the computer’s speed to medium. 

On Entry: AX = F16_ SET MEDIUM SPEED (6F 12H) 
On Exit: AH = OOH (Successful) 

Registers Altered: AX 


Keyboard Layout Identification 


Applications often need to know the layout of the keyboard attached to the system. The following is the 
recommended algorithm: 


1. Check bit 4 in byte 496H. If the bit is one, the keyboard is a HP Vectra Enhanced keyboard layout, 
or an industry-standard 101-key keyboard layout. If the bit is zero, the keyboard is an HP Vectra 
Keyboard /DIN layout, or an industry-standard 84-key keyboard layout. 

2. If bit 4 above equals zero, use function 6FOO to determine if the extended functions are present. If 
not, assume that the keyboard is a non-HP, 84-key keyboard layout. 

3. If extended functions are present, use function 6FO8 to determine whether the keyboard is an HP 
Vectra keyboard or some other third party keyboard. 
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EX-BIOS Keyboard Drivers for the HP Vectra Keyboard/DIN 


This section discusses Vectra Keyboard /DIN information related to ISR events and ISR Event Record: 
device driver chains, and HP-HIL device data input; these concepts were introduced in Chapter 4. 


Overview 






Ki N 7 - and only when an INT 16H 6F06 and 6FO7 
function has been called or when one of these functions is called directly. 


The EX-BIOS keyboard component consists of the logical keyboard driver, the keyboard translator 
services, and the V_ 8042 interface driver. 


Logical Keyboard Driver 


The logical keyboard driver is the primary interface for the physical keyboard and controls the process of 
scancode translation. Based on the keypad, the scancode is passed to one of five translator services: 
V_QWERTY, V_SOFTKEY, V_.FUNCTION, V_CCP and V__NUMPAD. Figure 5-2 shows the layout of 
the different keypad groups. This driver also maintains the state of the following keyboard modifier keys: 
<Ctrl>, left and right <Shift>, <Alt>, <Caps lock>, and <Num lock>. This state information is passed 
to the V_ CCP, V_ NUMPAD and V_QWERTY translator services. 


Keyboard Translators 


The keyboard translators act as subroutines for the logical keyboard driver. There are five translators 
corresponding to the keyboard keypads (see Figure 5-2). The five translators are: 


V_QWERTY handles the Typewriter keypad. 
V_FUNCTION handles ‘the Compatibility Function keypad (F1 - F10). 
V_NUMPAD handles the Numeric keypad (and its cursor keys). 
V_SOFTKEY handles the HP Function keypad (f1 - f10) 
V__CCP handles the Cursor Control keypad. 
The translators for the HP Function keypad and Cursor Control keypad are special cases. 
The V_SOFTKEY translator can translate its scancodes in the following ways: 
1. Map function keys f1 thru f8 into function keys Fl thru F8 (V_SKEY2FKEY). 
2. Throw away fl thru f8 function keys (V_ OFF). 


3. Pass back fl thru f8 function keys untranslated to the logical keyboard driver (V_ RAW). 
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The V_CCP translator can translate its scancodes in the following ways: 
1. Map Cursor Control keys to Numeric keypad cursor control scancodes (V_CCPCUR). 
2. Map Cursor Control keys to Numeric keypad scancodes (V_CCPNUM). 
3. Pass Cursor Control keys as untranslated scancodes to the logical keyboard driver (V_RAW). 
4. Throw away all Cursor Control (CCP) keys (V_ OFF). 


Functions are provided by the STD-BIOS INT 16H driver to select any of the above mappings. 


8042 Interface Driver 


The 8042 interface driver (V__8042) sends translated scancodes to the 8042 controller chip. If the 8042 
controller is busy this driver queues the scancode to be sent later when the 8042 controller is ready. In 
addition to passing scancodes from the keyboard to the 8042 controller, V_8042 processes keyboard 
controller commands to set keyboard LEDs and change keyboard typematic rates. 


Data Structures 


The EX-BIOS keyboard input system uses one data structure. The Keyboard ISR Event Record is a set of 
register definitions for inter-driver communication of input events. The following shows the Keyboard 
ISR Event Record definition. 


F_ISR (00H) 
Keyboard State (Only if state 
bit set in Data Type) 


On Entry: AH 
BH 


Bit Data Definition 


O7H 1 Left Unlabeled key pressed* 
O6H 1 Right Unlabeled key pressed* 
OSH 1 <Num lock> state active 

04H 1 <Caps lock> state active 

O3H 1 <Ctrl> key pressed 

02H 1 Right <Shift> key pressed 
O1H 1 Left <Shift> key pressed 

OOH 1 <Alt> key pressed 


BL = Scancode 


Bit Data Definition 

O7H 1 Break indicator 
0 Make indicator 

O6H-OOH Scancode 
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Number of bytes in buffer (scancode strings only) 


CX = 
DH = Data Type 
DL = Logical keyboard drivers vector address / 6 
BP = HP-HIL device n vector address . 
ES:SI = Pointer to buffer (scancode strings only) 
* These keys are located to the immediate left and right of the space bar. They are only 


available on some international keyboards. 


The Data Type field (DH) contains a code representing the current type of scancode contained in the ISR 
Event Record. When the logical keyboard driver calls a translator service, the Data Type will match the 
keypad group from which the scancode originated. After translation, the Data Type for the ISR Event 
Record returned to the logical keyboard driver should be T_KC_IBM_PC. See Table 5-13 for a 
complete list of keyboard event data types. 


Table 5-13. Keyboard Event Data Types 


T_KC_RO 

T_KC RI 
T_KC_ASCI 
T_KC_R3 
T_KC_ITF 
T_KC_RS 
T_KC_WILD 
T_KC_ENVOY 
T_KC_IBM_AT 
T_KC_BUTTON 
T_KC_IBM_PC 
T_KC_HP_SOFTKEY 
T_KC_IS_ FUNCTION 
T_KC_HP_ccP 


T_KC_QWERTY 
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Reserved 

Reserved 

ASCII data 

Reserved 

HP150 keyboard (ITF) scancode 
Reserved 


Device definable type 


HP Vectra Keyboard set 


IBM-AT scancode set 

Button data type 

IBM-PC scancode set 

HP Function keypad (f1-f8) 
Compatibility Function keypad (F1-F10) 
HP’s Cursor Control keypad 


Typewriter keypad 





Table 5-13. Keyboard Event Data Types (Cont.) 


T_KC_NUMPAD 


T_ STRING 


Logical Keyboard Driver 


Numeric keypad 


This is not a data type but an indicator bit for 
the keyboard data types only. If bit 4 is set, then 
the ISR Event record is for a string of scancodes 
pointed to by ES:SI and enumerated in CX; i.e., 
00x1 ttttB 

indicates a string of data bytes of type defined 
by the lower nibble ’tttt’. 


This is not a data type but an indicator bit for 
the keyboard data types only. If bit 5 is set, it 
indicates that the corresponding ISR Event 
record contains the current state in BH. 





The logical keyboard driver determines the keypad group the scancode belongs to and sets the Data Type 
field in the ISR event record. Based on the Data Type a translator service is called to handle the 


scancode. For example, if the "Q" key 


scancode comes through, the logical keyboard driver determines the 


data type to be T_KC_QWERTY and calls the V_QWERTY translator. If the translator called by the 
logical keyboard driver is responsible for any of the keyboard modifier keys the current state variable is 
placed in the ISR Event Record and the state indicator bit is set in the Data Type field. Table 5-14 
contains the scancode range to translator service assignments. 


Table 5-14. Scancode Range to Translator Service Assignments 


Scancode Range Translation Performed 


V_QWERTY 00H-36H 
38H-3AH 
5 SH-5FH 
6BH-6FH 
78H-7FH 


70H-77H 


3BH--42H (F1--F8) 
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Table 5-14. Scancode Range to Translator Service Assignments (Cont.) 


Scancode Range Translation Performed 


V_ FUNCTION 3BH-44H None 


V_NUMPAD 37H, 45H-54H None 


vV_CCP 60H-6AH Cursor Always - Regardless of state of the 
<Num lock> and <Shift> keys. 





If the translation was successful, the returned ISR Event Record is passed to the logical keyboard drivers 
parent (V_ 8042). 

Before passing a successful translation to its parent (V__8042) the logical keyboard driver performs two 
conditional tasks. First, it checks the state bit in the returned Data Type, if set the master copy of the 
keyboard state variable is updated with the copy returned in the ISR Event Record. Second, if the ISR 
event went to the V_CCP translator the logical keyboard driver takes the necessary steps to insure that 
cursor control keys are generated regardless of the <Num lock> and <Shift> key states. 


If a translator wants to remove the scancode from the scancode stream it must return a status code of 
RS_DONE to the logical keyboard driver (See the CCP2GID driver in Appendix G). 


Table 5-15 contains a summary of the logical keyboard driver functions. 


Table 5-15. Logical Keyboard Driver Function Code Summary 


Function Function . 
Value Equate Definition 


F_ Keyboard Driver (This driver does not have a fixed 
HP_VECTOR_ TABLE address) 


F_ ISR Logical Interrupt 


F SYSTEM System Intrinsics 


SF_INIT Driver initialization 


SF_VERSION_DESC Reports HP version number 
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Logical Keyboard Driver Function Definitions 


F__ISR (AH = OOH) 


This function processes the Keyboard ISR Event Record. It determines the range of the scancode, then 
calls the appropriate translation service. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard State (only if state bit set in Date type) 
BL = Scancode 
CX = Number of bytes in buffer (scancode strings only) 
DH = Scancode type 
DL = Vector address of keyboard / 6 
BP = HP-HIL device n vector address 
ES:SI = Pointer to buffer (scancode strings only) 


On Exit: AH = Return Status Code 
Registers Altered: AX, BX, CX, DX, SI, 

BP, ES, DS 
SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol utilized in data space allocation ("last used DS" passed in register BX). 


On Entry: AH = F_SYSTEM (02H) 


AL = SF_INIT (OOH ) 
BX = “Last used DS" in HP Data Area 
BP = HP-HIL device n vector address 


On Exit: AH 
BX 


Return Status Code 
New “last used DS" is 
HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL REE MtEr 
contains the number of years since 1960 and the BH register contains the week of the year. 
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On Entry: AH 
AL. 
BP 


F_SYSTEM (02H) 
SF_VERSION_DESC (06H) 
HP-HIL device n vector address 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current 
version number 
ES:DI = Pointer to the current version. 


number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


Keyboard Translators 


There is one keyboard translator service for each of the five keypad groups on the keyboard (see Figure 
5-2). Two of the five services are special cases in that they are actually chains of translators to facilitate 
keyboard mapping. Figure 5-1 shows the translators and their mapping possibilities. 


Applications may install routines to replace (or chain to) any one or all of the translators presented here. 
The INT 16H driver provides three functions to get the current HP_VECTOR_ TABLE entries for the 
five keypad translators, to set these same values, and to reset them to their default values. The 
V__SYSTEM driver in Chapter 8 provides functions to get or set any fixed HP_VECTOR_ TABLE entry 
(all EX-BIOS translators presented in this section have fixed entries). The V_ SYSTEM functions allow 
replacement of translators other than the main five called by the logical keyboard driver (those in 
translator chains). 


Applications that do not overlay existing translators, may install entirely new translators instead and map 
themselves into the HP Function and Cursor Control keypad translator chains as the parent drivers of the 
V_SOFTKEY and V_CCP services respectively. This method only works for the HP proprietary keypads. 


V__SOFTKEY (BP = 003CH) 


This translator service verifies the Data Type is T_ KC HP SOFTKEY and then passes the ISR Event 
Record to its parent. By default, this translator is mapped to the V_SKEY2FKEY service; alternative 
mappings are presented in Table 5-16. 


Table 5-16. V_SOFTKEY Driver Mapping Alternatives 


V_OFF Discards the ISR event. 


V_RAW Returns the scancode untranslated. 


V_SKEY2FKEY Translates the HP Function keys into their respective Compatibility 
Function key equivalents. 
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F ISR (AH = OOH) 


This function verifies the. passed in Data Type and passes the ISR event on to its parent. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_HP_SOFTKEY = OBH) 
DL = Source vector address / 6 
BP = V_SOFTKEY (003CH) 


On Exit: AH Return Status Code 


BL = Translated scancode 
BH = New keyboard state (only if state bit set in type) 
DH = New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol utilized in data space allocation (“last used DS" passed in register BX). 


On Entry: AH = F SYSTEM (02H) 
AL = SF_INIT (00H) 
BX = “Last used DS" in HP Data Area 
BP = V_SOFTKEY (003CH) 


On Exit: AH = Return Status Code. 
BX = "New last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF__VERSION_DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_SOFTKEY (003CH) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V_QWERTY (BP = 0036H) 


The V_QWERTY service verifies the correct Data Type. This service also maintains the state of the left 
and right <Shift> keys, the <Ctrl> key, the <Alt> key, the left and right unlabeled keys and the <Caps 
lock> key. 


F ISR (AH = OOH) 


This function verifies the Data Type, updates the keyboard state variable, and returns. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_QWERTY = OEH) 
DL = Source vector address / 6 
BP = V QWERTY (0036H) 


On Exit: AH 
BH 
DH 


Return Status Code 
New keyboard state (only if state bit set type) 
New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BH, DH, BP, DS 


SF_VERSION_DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_VERSION_ DESC (06H) 
BP = V_QWERTY (0036H ) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__FUNCTION (BP = 0042H) 


This service verifies the Data Type, sets a new Data Type and returns. 


F__ISR (AH = 00H) 


This function verifies the Data Type, and sets the new one. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_IS FUNCTION = OCH) 
DL = Source vector address 
BP = V_FUNCTION (0042H) 
On Exit: AH Return status code 


DH = New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, DH, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_VERSION DESC (06H ) 
BP = V_FUNCTION (0042H ) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__NUMPAD (BP = 0048H) 


The V_NUMPAD service is the scancode translator for the numeric keypad. It verifies the Data Type is 
correct and maintains the state of the <Num lock> and <ScrLck> keys. 


F ISR (AH = OOH) 


Verify Data Type and update state variable. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_NUMPAD = OFH) 
DL = Source vector address / 6 
BP = V_NUMPAD (0048H ) 
On Exit: AH = Return status code 
BH = New keyboard state (only if state bit set in type) 
DH = New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BH, DH, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH F_ SYSTEM (02H) 


AL = SF_VERSION DESC (06H) 
BP = V_NUMPAD (0048H ) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V_CCP (BP = 004EH) 


This translator service verifies the Data Type is T_KC HP CCP and then passes the ISR Event Record 
to its parent. By default this translator is mapped to the V_CCPCUR service, alternative mappings are 
presented in Table 5-17. 


Driver Name 


Table 5-17. V_CCP Driver Mapping Alternatives 


V_OFF 


V_RAW 


V_CCPNUM 


V_CCPCUR 


Discards the ISR event. 
Returns the scancode untranslated. 


Translates the cursor control pad scancodes into cursor or numeric key pad 
scancodes, depending on the <Num Lock> and <Shift> states. 


Translates the cursor control pad scancodes into cursor scancodes, regardless of 
the <Num Lock> and <Shift> states. 





F_ ISR (AH = OOH) 


This function verifies the Data Type and passes the event to its parent. 


On Entry: AH 


On Exit: AH 


F_ISR (00H) 

Keyboard state (only if state bit set in type) 
Scancode 

Scancode type (T_KC_HP_CCP = ODH) 

Source vector address / 6 

V_CCP (004EH) 


Return Status Code 

Translated scancode 

New keyboard state (only if state bit set in type) 
New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 
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SF__INIT (AX = 0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol utilized in data space allocation ("last used DS" passed in register BX). 


On Entry: AH F SYSTEM (02H) 


AL = SF_INIT (00H) 
BX = “Last used DS" in HP Data Area 
BP = V_CCP (O04EH) 


On Exit: AH 
BX 


Return Status Code 
New “last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH F_SYSTEM (02H) 


AL = SF_VERSION DESC (06H) 
BP = V_CCP (004EH ) 
On Exit: AH = Return Status Code 
BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__OFF Driver (BP = 0009CH) 
The V_OFF driver effectively turns off any translator mapped to it. It returns a Return Status Code of 


RS__DONE, this indicates to the driver which called that all processing is complete, and to return. 
Returning this status code effectively terminates processing of the scancode. 


F ISR (AH = OOH) 


This function sets a return status of RS DONE and exits. 


On Entry: AH = F_ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (any type accepted) 
DL = Source vector address / 6 
BP = V_OFF (O09CH ) 


On Exit: AH = RS_DONE 


Registers Altered: AX, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_OFF (009CH) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__RAW Driver (BP = 0090H) 


The V_RAW driver sets the data type to T_KC_IBM_PC (OAH) and returns, leaving the scancode 
untranslated. 


F__ISR (AH = OOH) 


This function sets a Data Type of T_KC_IBM_PC and a return status of RS_ SUCCESSFUL. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (any accepted) 
DL = Source vector address / 6 
BP = V_RAW (0090H ) 


On Exit: AH 
DH 


Return Status Code 
New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, DH, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF VERSION DESC (06H) 
V_RAW (0090H) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__CCPNUM (BP = 0096H) 


The V_CCPNUM driver converts scancodes from the HP cursor control keypad to their respective 
Numeric keypad equivalents. The resultant scancodes will be either numeric or cursor scancodes, 
depending on the state of the <Num Lock> and <Shift> keys. 


F__ISR (AH = OOH) 


This function translates the scancode, sets a new Data Type and exits. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_HP_CCP = ODH) 
DL = Source vector address / 6 
BP = V_CCPNUM (0096H ) 


On Exit: AH Return Status Code 


BH = New keyboard state (only if state bit set in type) 
BL = Translated scancode 
DH = New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF__VERSION_ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_CCPNUM (0096H) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__CCPCUR (BP = 008AH) 


The V_CCPCUR service converts scancodes from the Cursor Control Keypad to their respective numpad 
or cursor control equivalents. The <Shift> key states in the keyboard state variable are adjusted to cancel 
the effect of the <Num lock> key and force the Numeric keypad to operate in cursor mode. Upon return 
from this translator chain, the logical keyboard driver generates the appropriate <Shift> scancodes to 
account for the change to the keyboard state variable. 


F ISR (AH = OOH) 


This function translates the scancode to its Numeric keypad equivalent, changes the Data Type to 
T_KC_IBM_PC, and adjusts the keyboard state variable to force the Numeric keypad into cursor mode. 


On Entry: AH = F_ISR (OOH) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_HP_CCP = ODH) 
DL = Source vector address / 6 
BP = V_CCPCUR (008AH) 


On Exit: AH Return Status Code 


BH = New keyboard state (only if state bit set in type) 
BL = Translated scancode 
DH = New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BX, DH, BP, DS 


SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
V_CCPCUR (008AH) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V_SKEY2FKEY (BP = OOA8H) 
The V_SKEY2FKEY service translates HP Function key scancodes into their industry standard function 


key equivalents. The driver makes no attempt to verify that the scancode passed is in the range for an HP 
Function key. 


F_ ISR (AH = OOH) 


This function translates the scancode, sets the Data Type to T_KC_IBM_ PC and returns. 


On Entry: AH = F_ISR (00H) 
BH = Keyboard state (only if state bit set in type) 
BL = Scancode 
DH = Scancode type (T_KC_HP_SOFTKEY = OBH) 
DL = Source vector address / 6 
BP = V_SKEY2FKEY (OOA8H ) 


On Exit: AH 
BL 
DH 


Return Status Code 
Translated scancode 
New scancode type (T_KC_IBM PC = OAH) 


Registers Altered: AX, BL, DH, BP, DS 


SF__VERSION_ DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_VERSION DESC (06H) 
BP = V_SKEY2FKEY (OOASH ) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 
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V__8042 Driver (BP = OOAEH) 


This driver provides an interface to the 8042 keyboard controller chip. It responds to 8042 service 
requests and Input System logical interrupt requests (F_ISR’s) to output scancodes to the 8042 chip. It 
also provides an application interface to 8042 timer services and switch settings. Table 5-18 contains a 
function code summary for this driver. 


Func. 
Value 


Table 5-18. V__8042 Driver Function Code Summary 


Function 
| Equate 


V_ 8042 - 8042/keyboard interface. provides HP extensions to 
INT 16H 





















Processes ISR event record 





F_ISR 


F_SYSTEM 





System functions 





SF_INIT Initialize driver 


Driver start-up 





SF_START 


SF_VERSION _ DESC | Report HP version number 











04 F_IO_CONTROL Driver dependent functions 






04/00-0 Reserved 





04/0A 






SF_CREAT _INTR 





Create interval entry 





04/0C Delete interval entry 






SF_DELET _INTR 












04/0E SF_ENABL _INTR Enable interval 









04/10 SF_DISBL _INTR Disable interval 





04/12 SF_SET _RAMSW Set RAM switch to one (1) 












04/14 Set RAM switch to zero (0) 






SF_CLR _RAMSW 








04/16 SF_SET _CRTSW Set CRT switch to one (1) 












04/18 Set CRT switch to zero (0) 






SF_CLR _CRTSW 








04/1A 





SF_PASS _ THRU 





Pass data byte to 8042 
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V__8042 Driver Function Definitions 


F_ISR (AH = 


OOH) 


This function processes a Keyboard ISR Event Record. It checks to see if the 8042 will accept another 
scancode. If not, the scancode is placed in a queue. If the 8042 can accept a scancode, it writes the 
scancode out. The scancode queue has room for 127 entries plus one overrun character. 


On Entry: AH 
BH 

BL 

CX 

DH 

DL 

BP 

ES:SI 


On Exit: AH = 


F ISR (OOH) 

Keyboard state (only if state bit set in type) 
Scancode 

Number of scancodes in buffer (string type only) 
Scancode type 

Source vector address / 6 

V_8042 (OOAEH) 

Pointer to buffer (string type only) 


Return Status Code 


Registers Altered: AX, BP, DS 


SF__INIT (AX = 


0200H) 


This subfunction is called to initialize the driver. Refer to Chapter 8 for a complete discussion of the 
protocol utilized in data space allocation (“last used DS" passed in register BX). 


On Entry: AH 
AL 
BX 
BP 


On Exit: AH 
BX 


F_ SYSTEM (02H) 
SF_INIT (OOH) 
"Last used DS" in HP Data Area 
V_8042 (OOAEH) 


Return Status Code 
New "last used DS" in HP Data Area 


Registers Altered: AX, BX, BP, DS 


SF__ START (AX = 0202H) 


This subfunction starts the 8042 driver. 


On Entry: AH 
AL 
BP 


On Exit: AH = 


F_SYSTEM (02H) 
SF_START (02H) 
V_8042 (OOAEH) 


Return Status Code 


Registers Altered: AX, BP, DS 
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SF__VERSION__DESC (AX = 0206H) 


This subfunction returns the release date code and a double word pointer to the current version number. 
The date code consists of two BCD coded bytes containing the year and week of release. The BL register 
contains the number of years since 1960 and the BH register contains the week of the year. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_VERSION DESC (06H) 
BP = V_ 8042 (O0AEH) 


On Exit: AH Return Status Code 


BX = Release date code 
CX = Number of bytes in current version number 
ES:DI = Pointer to the current version number 


Registers Altered: AX, BX, CX, DI, ES, BP, DS 


SF__CREAT_INTR (AX = 040AH) 


The 8042 driver will call up to eight drivers at 1/60 second intervals. This subfunction creates an entry 
in the table of driver vectors which are called. Note that this subfunction only creates the entry; it does 
not enable the interval service. This is accomplished with the SF_ENABL_INTR subfunction. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_CREAT_INTR (OAH) 
BH = Vector number (vector address divided by six of 
driver requesting service 
BP = V_8042 (OOAEH) 


On Exit: AH = Return Status Code 
RS_FAIL indicates driver vector table full. 


Registers Altered: AX, BP, DS 


SF_DELET_INTR (AX = 040CH) 
This function removes the passed in vector number from the interval service table. 


On Entry: AH = F IO CONTROL (04H) 


AL = SF_DELET_INTR (OCH) | 

BH = Vector number (vector address divided by six) of 
driver to delete from table 

BP = V_ 8042 (OOAEH ) 


On Exit: AH = Return Status Code 
RS FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 
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SF_ENABL_INTR (AX = 040EH) 


This function enables interrupt service for a driver. The vector number passed is checked against the 
table. If an entry with that vector number is found, interval service is enabled. When the interval expires 
all enabled drivers in the list will be interrupted with a function code of F_SYSTEM (02H) in AH and a 
subfunction code of SF_INTERVAL (14H) in AL. 


On Entry: AH = F_IO CONTROL (04H) 


AL = SF_ENABL_INTR (OEH) 

BH = Vector number (vector address divided by six) of 
driver requesting service 

BP = V_ 8042 (O0AEH) 


On Exit: AH = Return Status Code 
RS FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 


SF__DISBL__INTR (AX = 0410H) 


This function disables interrupt service for a driver. The vector number passed is checked against the 
table. If an entry with that vector number is found, interval service is disabled. 


On Entry: AH = F_IO CONTROL (04H) 
AL = SF_DISBL_INTR (10H) 
BH = Vector number (vector address divided by six) of 
driver to be disabled 
BP = V_8042 (OOAEH ) 


On Exit: AH = Return Status Code 
RS_FAIL indicates vector not in table. 


Registers Altered: AX, BP, DS 


SF__SET__RAMSW (AX = 0412H) 


This function sets the industry standard extended RAM "switch" in the 8042 status register. This switch 
indicates that the second 256K RAM bank on the system board is enabled (default condition). 


On Entry: AH 
AL 


F_I0_ CONTROL (04H) 
SF_SET_RAMSW (12H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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SF__CLR__RAMSW (AX = 0414H) 


This function clears the industry standard extended RAM "switch" in the 8042 status register. When this 
switch is off it indicates that the second 256K RAM bank is disabled. 


On Entry: AH 
AL 


F_10 CONTROL (04H) 
SF_CLR_RAMSW (14H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_SET_CRTSW (AX = 0416H) 


This function sets the industry standard primary CRT "switch" in the 8042 status register. When the 
switch is set it indicates the primary display is attached to the Multimode graphics adapter (Default 
condition). 


On Entry: AH 
AL 


F_I0 CONTROL (04H) 
SF_SET CRTSW (16H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_CLR__CRTSW (AX = 0418H) 


This function clears the industry standard primary CRT "switch" in the 8042 status register. When this 
switch is clear it indicates the primary display is attached to the monochrome display adapter. 


On Entry: AH 
AL 


F_I0 CONTROL (04H) 
SF_CLR_CRTSW (18H) 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 


SF_PASS__THRU (AX = 041AH) 


This function outputs the byte in BL to the 8042 using the pass thru command to prevent the 8042 from 
interpreting the data as a scancode or a command. 


On Entry: AH 
AL 
BL 


F_IO CONTROL (04H) 
SF_PASS THRU (1AH) 
data byte to pass thru the 8042 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS 
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8042 Keyboard Controller 


This section discusses the role of the 8042 keyboard controller. The information presented applies to both 
the Vectra Enhanced keyboard and Vectra Keyboard /DIN, unless indicated otherwise. 


Overview 


The primary function of the 8042 keyboard controller is to manage the industry standard keyboard 
interface. (Directly accessing this hardware interface may affect program portability and is not 
recommended.) The 8042 keyboard controller also acts as a loopback buffer for the input system to the 
STD-BIOS keyboard driver. The 8042 is implemented in such a way as to maintain standard IBM PC/AT 
compatibility, while at the same time supporting all of the features of the input system. 


The 8042 keyboard controller accepts two sets of industry standard commands from the STD-BIOS 
drivers that control the operation of the controller and the keyboard itself. One set is controller 
commands, the other is keyboard commands (both sets are listed in Table 5-19). Controller commands 
are executed by the 8042 controller while keyboard commands are sent to the keyboard for execution. 


8042 Controller and Keyboard Commands 


Each of the controller command and keyboard command sets has its own protocol. The 8042 has two 
ports: a command port (I/O address 64H), and a data port (I/O address 60H). 8042 controller commands 
are written to the command port. If the command has parameters associated with it, the parameters are 
written to the data port. Keyboard commands are written to the data port. If the command has 
parameters associated with it, they are also written to the data port. All data written to the data port is 
interpreted as a keyboard command unless the previous command written to the command or data port 
required parameters. 


The following code writes a one-byte command to the 8042 controller to disable the keyboard interface. 


hp8042_ cmd port equ 64h ; IBM cmd/status port 
hp8042 status port equ 64h ; IBM cmd/status port 
hp8042 data_port equ 60h ; IBM data port 
hp8042_ ibf mask equ O2h ; Input buffer full mask 
hp8042 iface dis equ OADh ; Disable interface 
dis 8042 proc near 
push cx 3 save working set of regs 
push ax 
xor cx , cx 3; loop 64k times (if necessary) 
cli ; ints must be off for this loop 
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dis 8042 10: 

| in al,hp8042_ status port 
test al,hp8042_ibf_mask 
loopnz dis 8042 10 


we Oe we 


mov al,hp8042 iface dis ; 
out hp8042_ cmd_port,al 


we 


sti 
pop ax 
pop cx 
ret 

dis 8042 endp 


The following code writes a two byte command to the 


hp8042_cmd_port equ 64h 
hp8042 status port equ 64h 
hp8042 data port equ 60h 


we we we we 


hp8042 set_led equ  Oedh 
hp8042_ibf_mask equ 02h ; 
led data equ OTh 3 
set 8042 proc near 

push cx : 

push bx 

push ax 

xor cx , cx 


mov bh,led_ data 
mov b1,hp8042 set_led 
cli 


we we we we 


set 8042 10: 
in al,hp8042 status port ; 
test al,hp8042_ibf_mask ; 
loopnz set_8042 10 ; 


mov al,bl : 
out hp8042 data port,al : 
cmp bh,al : 
je set 8042 20 : 
mov bl,bh : 
xor cx , Cx 

jmp short set 8042 10 3 
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get status and see if 80286. 
input buffer if full . 
loop if it is 


load disable command and 
ship it out 


8042 to turn on all the keyboard LEDs at once. 


Hp8042 cmd/status port 
Hp8042 cmd/status port 
Hp8042 data port 

Set keyboard leds command 


Input buffer full mask 
Led mask to send out 


save working set of regs 


loop 64k times (if necessary) 
load data for loop 

load command 

ints must be off for this loop 


get status and see if 8042 
input buffer if full 


; loop if it is 


load command and 

ship it out 

did we output both bytes 
yes, skip out 

set up for next iteration 


loop 


set 8042 20: 
sti 3 CHANGE this to restore 
; int flag to previous state 
3; instead of on (if needed) 


pop ax 
pop bx 
pop cx 
ret 

set 8042 endp 


Table 5-19 lists the 8042 controller commands. These commands are categorized as READ, SNGL, or 
DBL. READ commands cause the 8042 controller to place the indicated data byte in it’s output buffer, 
input port 60H, to be read by the CPU. SNGL commands are commands written to output port 64H. 

DBL byte commands are written to output port 64H with the following data byte being written to output 
port 60H. 


Table 5-19. 8042 Controller Commands 


Reads byte zero of the 8042’s internal RAM. 
This byte is the last keyboard command sent to 
the 8042. 










021H-03FH Reads the byte specified by the lower five bits of 
the command in the 8042’s internal RAM. E.g. 
8042 controller command 34H will report con- 


tents of the 14H byte of the 8042’s RAM. 











060H-07FH Writes the data byte to the address specified in 


the low five bits of the command. 












Initiate Self-Test. This command instructs the 
8042 to perform a self test. If no errors are 
detected, 55H is returned in the data port. 


OAAH 











Initiate Interface Test. This command instructs 
the 8042 to test the interface between itself and 
the keyboard. (Always returns 0 = successful) 















Diagnostic Dump. The contents of the 8042 in- 
ternal RAM registers (16 bytes), output port, in- 
put port, and status word are sent to the system. 
All diagnostic data is sent to the system in the 

same manner as scancodes. (Not supported) 














Disable Keyboard. This command disables the 
keyboard. Bit 4 of the current command byte 
will be set to ’1’ in the 8042. This is equivalent 
to issuing a command byte with bit 4 set to 1’. 
Note that this command will have no effect if 
bit 3 of the command byte is set to ’1’. 
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Table 5-19. 8042 Controller Commands (Cont.) 


O0OAEH Enable Keyboard. This command re-enables the 
keyboard. Bit 4 of the current command byte is 
cleared in the 8042. This is equivalent to issuing 
a command byte with bit 4 set to ’0’. 


0COH Read Input Port. The current value of the input 
port is returned. Bit 7 indicates the status of the 
front panel keylock. Bits 0 - 3 will always be 
reported as 1’. Bits 4 - 6 are undefined. 


ODOH Read Output Port. The current value of the out- 
put port is returned. See Table 5-21 for bit 
definitions. 


ODIH Write Output Port. The next byte written to the 
data port will be written to the 8042 output 
port. The bit definitions for this port are given 
in Table 5-21. WARNING - The System Reset 
bit should not be written low. To reset the sys- 
tem, use the Pulse Output Port command. 


ODDH Disable Address Bit 20. Disables the A20 address 
of the processor address bit. This is the normal 


state of this pin the in real addressing mode. 


ODFH Enable address Bit 20. Enables the A20 address 
of the processor address bit. This state is only 
used in protected mode. 


QEOH Read Test Inputs. This command will output the 
current state of the 8042 test inputs, TO and T1. 
The current state of TO is stored in bit 0 and Tl 
in bit 1. Both bits will be reported as ’1’, unless 
the keyboard interface is inhibited. Bits 2 
through 7 are undefined. 


OFOH-OFFH Pulse Output Port. Bits 0 - 3 of the output port 
may be pulsed low for approximately 6 micro- 
seconds. Bits 0 through 3 contain a mask which 
is interpreted by the 8042 to determine which 
bits are pulsed. A bit is pulsed if its correspond- 
ing mask bit is ’0’; if it is ’1’ its current state is 
maintained. Note - The System Reset bit is con- 
nected to bit O. If the system needs to be reset, 
this command should be used (1.e., the bit should 
be pulsed, not brought low indefinitely.) 
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Table 5-20 indicates the format of the data byte written to the 8042 Controller subsequent to the 8042 
Command 20H listed in Table 5-19. 


Table 5-20. 8042 Command Byte Format 


Reserved--must always be 0. 


Scancode conversion mode. 

The scancodes received from the keyboard are converted into PC/XT 
scancodes. 

Convert to AT scancodes. 


Acts as a NOP (No Operation instruction). 


Disable Keyboard. Data will not be sent or received by the keyboard. 
Disables the keyboard. 
Restore operation. 


Inhibit override. 
Prevents the keyboard from being disabled via the computer’s 
Security Keylock. 


System Flag. The value of this bit is stored as the System Flag Bit. 
This bit may be read via port 60H. 


Reserved--must always be 0. 

Instructs the 8042 to issue an OBF (Output Buffer Full) interrupt 
when data is in the output buffer. 

Disables this feature. 





Table 5-21 indicates the format of the data byte written to the 8042 controller subsequent to the 8042 
Command Write Output Port ODIH, or read from the 8042 controller subsequent to the 8042 Command 
Read Output Port ODOH. 


Table 5-21. 8042 Command Output Port Bit Mask 


Keyboard data line 
Keyboard clock line 
Undefined 


Output Buffer Full Interrupt (OBF) 
Undefined 

Undefined 

A20 Gate 

System Reset 
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Table 5-22 lists the keyboard commands. These commands are categorized as SNGL or DBL. SNGL 
commands are commands written to output port 60H. DBL byte commands are written to output port | 
60H with the subsequent data byte, also, being written to output port 60H. The coding examples given 
for 8042 controller commands is similar to the procedure for writing keyboard commands. The notable 
exception being the I/O address 60H is substituted for the I/O address 64H (defined with the equate, 
hp8042_cmd_port). 


Table 5-22. Keyboard Commands 


Set /Reset Mode Indicators. The keyboard has three status indicators; 
Caps lock, Num lock, and Scroll lock. This command is used to turn 
these indicators on and off. After the command is issued, the system 
must wait for an ACK (OFAH in Table 5-28) from the keyboard 
(see below). When it is received, a second byte is issued to the 
keyboard. Bits 0 - 2 represent Scroll lock, Num lock, and Caps lock, 
respectively. Setting their respective bits to 1 turns the indicator on, 
while a O turns it off. Bits 3 - 7 should be set to 0. (See Table 
5-23) 














Echo. This is a diagnostic tool. When this command is issued, the 
keyboard returns an EEH. 

















No Operation (NOP). These codes are reserved for future use. The 
keyboard will acknowledge these codes, but no other action will be 
performed. 






Select Alternate Scancodes. This command instructs the keyboard to 
select one of three sets of scancodes. When the keyboard receives this 
command it responds with an ’ACK’ and clears the output buffer 
and the typematic key (if one is active). The system then sends the 
option byte to select the appropriate scancode set: O1H selects set 1, 
02H selects set 2, 03H selects set 3. The keyboard responds to this 
with another ACK’. (See Tables 5-24a, 5-24b, and 5-24c). 












No Operation (NOP). These codes are reserved for future use. The 
keyboard will acknowledge these codes, but no other action will be 
performed. 











Request Keyboard Identification information. The keyboard responds 
with an ’ACK’, discontinues scanning and sends the two keyboard ID 
bytes. The second byte must follow the first by no more then 500 
microseconds. After the output of the second ID byte, the keyboard 
resumes scanning. 


Set Typematic Rate/Delay. This command sets the values for the 
typematic rate and delay. 


The typematic rate is the number of make scancodes per second sent 


in the typematic (repeat) mode. The delay is the amount of time a 
key must be held down until it enters the typematic mode. 
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Table 5-22. Keyboard Commands (Cont.) 


| 


The rate and delay are passed in the next byte after the command. 
Bits 0 through 4 contain the rate and bits 5 and 6 contain the delay. 
Bit 7 is unused. . 









The 8042 chip accepts STD AT typematic commands which are com- 
posed of two bits of delay (6,5) and five bits of rate (4 - 0). The 

two low order bits of the rate value are stripped off by the 8042 and 
the result translated into the typematic rate. (See Table 5-27.) 







Enable. This command enables keyboard action. The keyboard will is- 
sue an ’ACK’ response, then begin sending scancodes as keys are 
pressed. 









Default Disable. This command sets the keyboard parameters to their 
power-on default state and disables the transmission of scancodes. 
The keyboard will send an ’ACK’ response to this command. 












Set Default. This command sets the keyboard parameters to their 
power-on state and sends an ’ACK’ response. the keyboard will con- 
tinue to transmit scancodes after receipt of this command. 








Set All Keys Typematic. When the keyboard receives this command 
it responds with an ’ACK’, clears output buffers, sets all keys to 

typematic and continues scanning. This command can be sent using 
any scancode set, but only set 3 is affected. 











Set All Keys Make/Break. When the keyboard receives this command 
it responds with an ’ACK’, clears output buffers, sets all keys to 

make/break and continues scanning. This command can be sent using 
any scancode set, but only set 3 is affected. 












Set All Keys Make. When the keyboard receives this command it 
responds with an ’ACK’, clears output buffers, sets all keys to make 
and continues scanning. This command can be sent using any scan- 
code set, but only set 3 is affected. 











Set All Keys Typematic/Make/Break. When the keyboard receives 
this command it responds with an ’ACK’, clears output buffers, sets 
all keys to typematic/make/break and continues scanning. This 
command can be sent using any scancode set, but only set 3 is 
affected. 















Set Key Typematic. When the keyboard receives this command it 
clears output buffers to receive key ID. The system identifies each 
key by its scancode set 3 value (the only valid means of key iden- 
tification). Each identified key is set to typematic. 
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Table 5-22. Keyboard Commands (Cont.) 


Set Key Make/Break. When the keyboard receives this command it 
clears output buffers to receive key ID. The system identifies each 

key by its scancode set 3 value (the only valid means of key iden- 

tification). Each identified key is set to make/ break. 


Set Key Make. When the keyboard receives this command it clears 
output buffers to receive key ID. The system identifies each key by 
its scancode set 3 value (the only valid means of key identification). 
Each identified key is set to make. 


Resend. This command may be sent to the keyboard whenever an er- 
ror is detected by the system. This command must be sent before the 
next scancode is to be transmitted. If the last code sent by the 
keyboard was a Resend command, the Keyboard will send the prior 
code. 


Reset. This command instructs the keyboard to perform its Power-On 
Reset function. This step takes at least 300 milliseconds, during 
which the keyboard is disabled. 





Table 5-23 indicates the format of the data byte written to the output port 60H subsequent to the 
Keyboard Command ’Set Mode Indicators’ OEDH. 


Table 5~23. Set Mode Indicators Data Byte Format 


07H-03H Reserved, should be set to zero 


02H Caps Lock Mode Indicator 
Turns off Caps Lock indicator 
Turns on Caps Lock Indicator 


Num Lock Mode Indicator 
Turn off Num Lock indicator 
Turn on Num Lock indicator 


Scroll Lock Mode Indicator 
Turn off Scroll Lock indicator 
Turn on Scroll Lock indicator 
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Tables 5-24, 5-25 and 5-26 list the three scancode sets that can be switched to and from by the 
keyboard command OFOH (select alternate scancodes). The system defaults to scancode set 2. 
Scancode Set 1 


In this set, keys are assigned a base scancode (extra codes generate artificial shift states in the system, in 
some cases). The typematic scancodes are identical to the base scancode for each key. 


In part one of the following table, keys send the codes shown (regardless of any shift states). Refer to 
Figures 5-2 and 5-3 for keyboard layouts showing the associated key numbers. 


TABLE 5-24a. SCANCODE SET 1 (PART 1) - 


Key Number Make Code Break Code Key Number Make Code Break Code 


1 
2 
3 
4 
5 
6 
7 
8 
9 


* 


101-key keyboard only. 
** 102-key Keyboard only (non-US). 
““* Asian keyboard only. 





Keyboard 5-59 


The next parts show a series of codes dependent on the state of the keys <Ctrl>, <Alt>, <Shift> and 


<Num Lock>. Since the base scancode is the same as that of another key, an extra code (EO hex) has 
been added to the base to make it unique. 


TABLE 5-24b. SCANCODE SET 1 (PART 2) 


Base Case, or 


Shift + Num Lock 


Make / Break 


Shift Case 
Make / Break * 


EO AA E0 52/ 
EO D2 E0 2A 
EO AA E0 53/ 
EO D3 E0 2A 
EO AA EO 4B/ 
E0 CB E0 2A 
EO AA E0 47/ 
EO C7 £0 2A 
EO AA E0 4F / 
EO CF E0 2A 
EO AA E0 48/ 
EO C8 E0 2A 
EO AA EO 50/ 
EO DO E0 2A 
EO AA E0 49/ 
E0 C9 E0 2A 
EO AA EO 51/ 
EO D1 E0 2A 
EO AA E0 4D / 
EO CD E0 2A 


Num Lock on 
Make / Break 


EO 2A E0 52/ 
EO D2 EO AA 
EO 2A E0 53/ 
EO D3 EO AA 
EO 2A E0 48 / 
EO CB EO AA 
EO 2A E0 47/ 
EO C7 EO AA 
EO 2A E0 4F / 
EO CF EO AA 
EO 2A E0 48/ 
EO C8 EO AA 
EO 2A E0 50/ 
EO DO EO AA 
EO 2A E0 49/ 
EO C9 EO AA 
EO 2A E0 51/ 
EO D1 EO AA 
EO 2A E0 4D / 
EO CD EO AA 


* The AA/2A shift make and break is sent with the other scancodes if the left Shift key 
is held down. If the right Shift key is held down, then B6/36 is sent. Both sets of 
codes are sent with the other scancode if both Shift keys are held down. 





TABLE 5-24c. SCANCODE SET 1 (PART 3) 


Key Scancode Shift Case 
Number Make / Break Make / Break * 


95 E0 35 / EO AA E0 35/ 
E0 B5 E0 B5 E0 2A 


* The AA/2A shift make and break is sent with the other scancodes if the left Shift key 
is held down. If the right Shift key is held down, then B6/36 is sent. Both sets of 
codes are sent with the other scancode if both Shift keys are held down. 





TABLE 5-24d. SCANCODE SET 1 (PART 4) 


Scancode Ctrl Case, Shift Case Alt Case 
Make / Break Make / Break Make / Break 


EO 2A E0 37/ E0 37/0 B7 54/D4 
EO B7 EO AA 





TABLE 5-24e. SCANCODE SET 1 (PART 5) 


Key Number Make Code Ctrl Key Pressed 


126 * E11D45E19DC5 E0 46 E0 C6 


* Not a Typematic key. All associated scancodes occur on the make of the key. 
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Scancode Set 2 

In this set, when a key is pressed, each key is assigned a unique 8-bit make scancode. Each key also sends 
a break code when the key is released. The break code is made up of 2 bytes: the first being the break 
code prefix (FO hex), and the second being the make scancode for that key. 


In part one of the following table, keys send the codes shown (regardless of any shift states). Refer to 
Figures 5-2 and 5-3 for keyboard layouts showing the associated key numbers. 


TABLE 5-25a. SCANCODE SET 2 (PART 1) 


Key Number Make Code Break Code Key Number Make Code Break Code 


FO 21 
FO 2A 
FO 32 
FO 31 
FO 3A 
FO 41 
FO 49 
FO 4A 
FO 59 
FO 14 
FO 5E 
FO 11 
FO 29 
EO FO 11 
FO 5F 
EO FO 14 
FO 77 
FO 6C 
FO 6B 
FO 69 
FO 75 
FO 73 
FO 72 
FO 70 
FO 7C 
FO 7D 
FO 74 
FO 7A 
FO 71 
FO 7B 
FO 79 
EO FO 5A 
FO 76 
FO 05 
FO 06 
FO 04 
FO 0C 
FO 03 
FO 0B 
FO 83 
FOOA 
FO 01 
FO 09 
FO 78 
FO 07 
FO 7E 


OON OANA AN — 


* 101-key keyboard only. 
** 102-key keyboard only (non-US). © 
*** Asian keyboard only. 
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The next parts show a series of codes dependent on the state of the keys <Ctrl>, <Alt>, <Shift> and 
<Num Lock>. Since the base scancode is the same as that of another key, an extra code (EO hex) has 


been added to the base to make it unique. 


$-62 


TABLE 5-25b. SCANCODE SET 2 (PART 2) 


Base Case, or 
Shift + Num Lock 
Make / Break 


E0 70 / 
EO FO 70 
EO 71/ 
EO FO 71 
EO 6B / 
EO FO 6B 
E06C/ 
EO FO6C 
E0 69 / 
EO FO 69 
EO 75 / 
EO FO 75 
E0 72/ 
EO FO 72 
E0 7D / 
EO FO 7D 
EO 7A / 
EO FO 7A 
EO 74/ 
EO FO 74 


Shift Case 
Make / Break * 


E0 FO 12 E0 70/ 
EO FO 70 E0 12 
EO FO 12 E071/ 
EO FO 71 E0 12 
E0 FO 12 E06B/ 
E0 FO 6B E0 12 
E0 FO 12 EQ 6C/ 
EO FO 6C E0 12 
EO FO 12 E069/ 
EO FO 69 E0 12 
EO FO 12 E075/ 
E0 FO 75 E0 12 
EO FO 12 £0 72/ 
EO FO 72 EO 12 
EO FO 12 E07D/ 
EO FO 7D E0 12 
E0 FO 12 E0 7A/ 
EO FO 7A E0 12 
EO FO 12 £0 74/ 
EO FO 74 E0 12 


Num Lock on 
Make / Break . 


EO 12 EO 70/ 

EO FO 70 EO FO 12 
EO 12E071/ 

EO FO 71 E0 FO 12 
EO 12 E06B/ 

EO FO 6B E0 FO 12 
EO 12 EO 6C/ 

EO FO 6C E0 FO 12 
EO 12 E069/ 

EO FO 69 EO FO 12 
EO 12 E0 75/ 

EO FO 75 EO FO 12 
EO 12 E0 72/ 

EO FO 72 E0 FO 12 
EO 12 E07D/ 

EO FO 7D E0 Fo 12 
EO 12 E0 7A/ 

EO FO 7A E0 FO 12 
EO 12 E074/ 

EO FO 74 E0 FO 12 


“ The FO 12/12 shift make and break is sent with the other scancodes if the left Shift key 


is held down. 


If the right Shift key is held down, then FO 59/59 is sent. Both sets of 


codes are sent with the other scancode if both Shift keys are held down. 


TABLE 5-25c. SCANCODE SET 2 (PART 3) 





















Number 


is held down. 





Scancode 
Make / Break 





EO 4A/ 
EO FO 4A 


Shift Case 


Make / Break * 


EO FO 12 4A/ 
EO 12F0 4A 


TABLE 5-25d. SCANCODE SET 2 (PART 4) 


Scancode 
Make / Break 


EO 12E07C/ 
EO FO 7C EO FO 12 


Ctrl Case, Shift Case 


Make / Break 


E0 7C/E0 F07C 














* The FO 12/12 shift make and break is sent with the other scancodes if the left Shift key 
If the right Shift key is held down, then FO 59/59 is sent. Both sets of 
codes are sent with the other scancode if both Shift keys are held down. 


Alt Case 


Make / Break 


84/F0 84 





TABLE 5-25e. SCANCODE SET 2 (PART 5) 


Key Number 


Make Code 


Ctrl Key Pressed 





126 * 


E114 77 E1 F014 FO 77 


EO 7E E0 FO 7E 


* Not a Typematic key. All associated scancodes occur on the make of the key. 
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Scancode Set 3 


In this set, when a key is pressed, each key is assigned a unique 8-bit make scancode. Each key also sends 
a break code when the key is released. The break code is made up of 2 bytes: the first being the break 
code prefix (FO hex), and the second being the make scancode for that key. 


In part one of the following table, keys send the codes shown (regardless of any shift states). Refer to 
Figures 5-2 and 5-3 for keyboard layouts showing the associated key numbers. 


TABLE 5-26. SCANCODE TABLE: SET 3 


Key . Make Break Default Key Make Break Default 
Number Code Code Key State Number Code Code Key State 


FO OE Typematic Typematic 
FO 16 Typematic Make/Break 
FO 1E Typematic Make/Break 
FO 26 Typematic Typematic 
FO 25 Typematic Make/Break 
FO 2E Typematic Typematic 
FO 36 Typematic Make only 
FO 3D Typematic Typematic 
FO 3E Typematic Make only 
FO 46 Typematic Make only 
FO 45 Typematic Typematic 
FO 4E Typematic Typematic 
FO 55 Typematic Make only 
FO 66 Typematic Make only 
FO OD Typematic Typematic 
FO 15 ' Typematic Typematic 
FO 1D Typematic Make only 
FO 24 Typematic Make only 
FO 2D Typematic Typematic 
FO 2C Typematic Make only 
FO 35 Typematic Make only 
FO 3C Typematic Make only 
FO 43 Typematic Make only 
FO 44 Typematic Make only 
FO 4D Typematic Make only 
FO 54 Typematic Make only 
FO 5B Typematic Make only 
FO 5C Typematic Make only 
FO 14 Make/Break Make only 
FO 1C Typematic Make only 
FO 1B Typematic Make only 
FO 23 Typematic Make only 
FO 2B Typematic Make only 
FO 34 Typematic Make only 
FO 33 Typematic Typematic 
FO 3B Typematic Make only 
FO 42 Typematic Make only 
FO 4B Typematic Make only 
FO 4C Typematic Make only 
FO 52 Typematic Make only 
FO 53 Typematic Make only 
FO 5A Typematic Make only 
FO 12 Make/Break Make only 
FO 13 Typematic Make only 
FO 1A Typematic Make only 
FO 22 Typematic Make only 
FO 21 Typematic Make only 
FO 2A Typematic Make only 
FO 32 Typematic Make only 
FO 31 Typematic Make only 
FO 3A Typematic Make only 
FO 41 Typematic Make only 
Fo 49 Typematic 


OON AMA WM — 


* 101-key keyboard only. 
“* 102-key keyboard only (non-US). 
““* Asian keyboard only. 
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Table 5-27 lists the range of typematic rate values for the keyboard as set by the OF3H command. The 
default values for the keyboard are: 


Typematic rate = 10.9 characters per second + 20% 
Delay = 500 milliseconds + 20% 


Table 5-27. Typematic Rate 


4.0 
3.7 
3.3 
3.0 
2.7 
2.5 
2.3 
2.1 
2.0 





The typematic rate (make codes per second) is 1 for each period. The period is the interval from one 
typematic output to the next as determined by this equation: 


Period = (8 + A) X (28) X 0.00417 seconds. Where: 


A = binary value of bits 2, 1, and 0. 
B = binary value of bits 4 and 3. 


Note that if the keyboard receives a command other than the rate/delay value byte, the execution of 
OF3H is halted without change to the existing rate. 
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Table 5-27 lists the range of typematic rate values for the keyboard as set by the OF3H command. The 
default values for the keyboard are: 


Typematic rate = 10.9 characters per second + 20% 
Delay = 500 milliseconds + 20% 


Table 5-27. Typematic Rate 


7.5 
6.7 
6.0 
5.5 
5.0 
4.6 
4.3 
4.0 
3.7 
3.3 
3.0 
2.7 
2.5 
2.3 
2.1 
2.0 





The typematic rate (make codes per second) is 1 for each period. The period is the interval from one 
typematic output to the next as determined by this equation: 


Period = (8 + A) X (2) x 0.00417 seconds. Where: 


A = binary value of bits 2, 1, and 0. 
B = binary value of bits 4 and 3. 


Note that if the keyboard receives a command other than the rate/delay value byte, the execution of 
OF3H is halted without change to the existing rate. 
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8042 to STD-BIOS Scancodes and Commands 


The keyboard sends scancodes and commands to STD-BIOS driver system . The scancodes/commands are 
read from the 8042 data port (Input Port 60H). Table 5-28 lists the keyboard codes returned by the 
keyboard. 


Table 5-28. 8042 to STD-BIOS Scancodes and Commands 


Code / | 
Command Description 


00H OVERRUN. This code indicates that the 16 character keyboard buffer has 
overflowed. 


01H-77H Keyboard Scancodes. These represent the keys on the 81H-OF7H keyboard. 
The translations for these scancodes are listed in Table 5-6. 


OAAH The 8042 controller will report this byte when it completes the 8042 control- 
; ler’s Self Test. This test is executed at power-on and, after receiving the 
Keyboard Command OFFH, reset. Note: any other byte reported at these 
times indicates failure. 


ECHO: this code is sent in response to the keyboard ECHO. COMMAND 
command, OEEH. 


Break Prefix code. This code is sent to indicate a key break. This code is fol- 
lowed by the scancode of the key being released. This code will be sent only 
in the AT scancode set mode. 


ACK. this code is sent to acknowledge receipt of a command (except Echo 
and Resend). 


Keyboard Self Test Failure. This code is sent by the keyboard to indicate a 
failure during the keyboard Self Test (Keyboard Command OFFH). 


Diagnostic Failure. This code is sent if a keyboard failure is detected. 


Resend. This code is sent if the keyboard receives an invalid command or 
detects an error in the transmission. 
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Logical Keyboard to 8042 Driver Communication 


The 8042 acts as an intelligent bi-directional buffer between the logical keyboard driver (Input System) 
and the INT 09H driver and system software. The INT 09H driver and system software communicate 
with the 8042 via the command and data ports (I/O addresses 64H and 60H respectively). The 8042 has 
an additional port (I/O address 68H) which is used by the logical keyboard driver to transfer data and 
commands to the 8042 without overlapping with the industry standard keyboard commands. Data such as 
keyboard scancodes and commands are transmitted in this manner. To verify that the command has been 
read, the software can read the IBF bit in the status register of the controller. The HP specific 
commands to the 8042 are listed in Table 5-29. 


Table 5-29. HP-Specific Commands to the 8042 


Keycode 
Value Keycode /Command Definition . 


00H-054H Industry standard make scancodes. The data byte is put into an 8042 internal 
scancode buffer, then will loopback the scancode buffer when the 8042’s out- 
put port is empty. 




























80H-0D4H Industry standard break scancodes. The data byte is put into an 8042 internal 
scancode buffer, then will loopback the scancode buffer when the 8042’s out- 


put port is empty. 





055H-077H HP-enhanced keyboard make scancodes. The data byte is put into an 8042 in- 
ternal scancode buffer, then will loopback the scancode buffer when the 


8042’s output port is empty. 





ODSH-0F7H HP-enhanced keyboard break scancodes. The data byte is put into an 8042 
internal scancode buffer, then will loopback the scancode buffer when the 


8042’s output port is empty. 
Reserved 
Reserved 
Pass through the next data byte written to output port 068H. The data byte 


will be put into an 8042 internal scancode buffer, then will loopback the 
scancode buffer when the 8042’s output port is empty. 










Set the RAM Switch to ’0’. 
Set the RAM Switch to ’1’ (Default). 


CRT_OFF: Set the CRT Switch to ’0’. Indicates the primary display adapter 
is a IBM Monochrome/ Printer or HP Monochrome Plus adapter. 


CRT_ON: Set the CRT Switch set to ’1’. Indicates the primary display adapt- 
er is the IBM Color/Graphics or HP Muitimode adapter (Default). 







HP Reserved 
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Table $-29. HP-Specific Commands to the 8042 (Cont.) 


| Keycode /Command Definition 


ENABLE _AUTOPOLL: Enables the SVC Port request AUTOPOLL_ EVENT 
to be sent to the system. This command allows the CPU to take over the 
HP-HIL polling function. The AUTOPOLL_EVENT SVC request is made ap- 
proximately 60 times a second whenever this command is in effect. 


Keycode 
Value 







OF9H 





DISABLE_AUTOPOLL: Disable the AUTOPOLL_EVENT SVC request. 









OFAH-OFEH Reserved 





KEYBOARD_OVERRUN: This is passed through as any normal keyboard 
scancode. This command is sent from the 8042 driver to the logical keyboard 
to the 8042 chip to indicate the logical keyboard’s data buffer was overrun. 





OFFH 
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This chapter covers the ROM BIOS support for the system serial and parallel I/O ports. The ROM BIOS 
supports up to three parallel ports and up to four serial ports. 


Note: HP Vectra systems using MS-DOS 3.1 version A.01.04 or greater support three parallel and four 
serial ports. MS-DOS 3.1 versions less than A.01.04 support three parallel and two serial ports. 


Overview 


The ROM BIOS provides two STD-BIOS drivers that control the serial (INT 14H) and parallel (INT 17H) 
ports. The functions in these drivers provide a means of setting communication parameters and 
transmitting data. These drivers have expanded functionality that provide the programmer with the 
ability to set higher baud rates and to transfer strings of data. In addition to these drivers, the print 
screen driver (INT 05H) will be discussed in this chapter. 


Serial and Parallel Port Addresses 


The STD-BIOS data area contains two tables used by the serial and parallel port drivers. The Serial Base 
Port Address Table contains the base port addresses for the serial ports. The Parallel Base Port Address 
Table contains the base port addresses of the parallel ports. The ROM BIOS checks during SYSGEN for 
the presence of serial and parallel adapter cards at the addresses listed in Table 6-1. When a valid port is 
found, the base address of that port is placed in the next available entry of the appropriate table. 
Application programs may add additional parallel ports or serial ports to the port tables. An application 
program can also replace the values in the table with new ones to support non-standard port addresses. 
Each table contains space for four entries. 


Table 6-1. Serial and Parallel Port Addresses 


1/O Address 


COM1, AUX 
COM2 
COM3 
COM4 
LPT1, PRN 
LPT2 

LPT3 
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Port addresses are added to the base port address tables in the sequence listed in Table 6-1. If the system 
has only two parallel I/O ports at addresses 378H and 278H, then 378H becomes the first entry in the 
table (Port 0 - LPT1, PRN) and 278H becomes the second (Port 1 - LPT2). The potential parallel port 
at 3BCH would not be Port 0 as it is not present in the system. 


The functions supported by the serial and parallel port drivers rely on the values contained in the serial 
base port address table and the parallel base port address table. The ports are referenced by indexes to the 
tables (port numbers 0-3). 


Print Screen Driver 


The print screen driver provides a simple method for application programs and system software to print a 
copy of the screen contents to the system printer (port 0). The ROM BIOS print screen driver will only 
print the screen if the display adapter is in one of the alphanumeric modes. Support for printing the 
screen when in graphics modes is provided by the DOS command GRAPHICS. 


Polled and Interrupt Driven Operations 


Both the serial and parallel ports on the system may be operated in either a polled or interrupt mode. The 
drivers in the ROM BIOS only support polled operation. Four system interrupts, O0BH, OCH, 72H and 73H, 
are reserved for system serial ports. Two system interrupts, ODH and OFH, are reserved for system parallel 
printers. Application programs and system software may use these interrupts to operate the ports in an 
interrupt mode. 


Data Structures 


The data structures for the serial port, parallel port, and print screen drivers are located in the STD-BIOS 
data area. The data structures for each of the drivers are discussed separately. 


Serial Port Driver Data Structures 


The serial port driver uses two data structures in the STD-BIOS data area; a base port address table, and 
a timeout counter table. The addresses of these data structures are listed in Table 6-2. The equipment 
word in the STD-BIOS data area (40:10H), contains the number of serial and parallel ports configured in 
the system. The equipment byte can be read by the INT 11H equipment determination function. 
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Table 6-2. Serial Port Data Structures 


Port Port Address Timeout Timeout 
Number Table Entry Table Entry (Default) 





Each serial port is comprised of eight I/O addresses. The base address of each block of I/O addresses is 
stored in the base port address table. For more information, see the HP Vectra Hardware Technical 
Reference Manual (for the HP Vectra ES, QS, or RS personal computers). The table consists of 4 words 
(8 bytes), one for each of the four possible serial ports. A zero value for any of the words is interpreted 
by the driver to mean the port is not present. 


The second data structure used by the serial port driver is the timeout table. This data structure consists 
of 4 bytes, one for each of the serial ports. Whenever the driver attempts to read or write data or 
parameters it reads the status port on the serial port. To prevent an error condition on the serial port 
from hanging up the system it uses a timeout loop. If a valid status byte cannot be read within the time 
allotted, the driver will return with a timeout error status code. The length of the timeout is determined 
by the entries in the timeout table. Each of the four serial ports can be given a different timeout value 
by an application program. 


Parallel Port Driver Data Structures 
The parallel port driver uses two data structures that are similar to those used by the serial port driver: 
the base port address table and timeout counter table. Base port addresses and timeout tables for the 


parallel port driver are listed in Table 6-3. 


Table 6-3. Parallel Port Data Structures 


Port Port Address Timeout Timeout 
Number Table Entry Table Entry (Default) 


(14H) 






Each of the parallel ports occupy four I/O addresses. The base or first address of each is contained in the 
base address table. A zero value for any of the words is interpreted by the driver to mean the requested 
parallel port adapter is not present. 


The parallel printer port driver checks the status of the port before it outputs a character to determine if 
the printer is busy. To prevent an error condition on the parallel port from hanging up the system, a 
timeout loop is used. The length of the timeout is determined by the values stored in the timeout table. 
The timeout values for each of the parallel ports can be set independently of each other. 
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Print Screen Driver Data Structures 


The print screen driver uses a single byte data structure, located at 0040:0100H (see Appendix B). The 
print screen driver places a status byte at this location, indicating whether or not a print screen operation 
is underway. The possible values for this status byte are: 


The print screen driver has not been called or it completed the previous 


operation successfully 
Printing is in progress. 
Error occurred during printing. 





If this byte indicates a print screen operation is currently in progress, the driver will return. This prevents 
more than one print screen operation from occurring at the same time. 


Serial Port Driver (INT 14H) 


The functions supported by the serial port driver can be divided into two groups; those that set and report 
communication protocol or status, and those that transmit and receive data. The driver supports nine 
functions. Four of these functions implement the features of the industry standard INT 14H driver. The 
remaining five functions are EX-BIOS extensions. The ROM BIOS supports several features not found in 
the industry standard INT 14H driver. Among these features is the ability to select a communication 
speed of up to 19.2 K baud per second and the support of block (multi-byte) data transfer. 


Table 6-4 summarizes each of the Serial Port Driver (INT 14H) functions. It is followed by a description 
of each function. 


Table 6-4. Serial Port Driver Function Code Summary 


Function Function 
Equate Value 






Definition 






INT_SERIAL Serial 

F14_ INIT Initialize Serial Port Parameters 
Fi4 XMIT Send Out One Character 

Fi4 RECV Receive One Character 

F14 STATUS Get Serial Port Status 

F14 INQUIRE EX-BIOS present 

F14_EXINIT Initialize serial port (19.2 Kbaud) 
Fl4_ PUT_BUFFER Write a buffer of data 

Fl4_ GET BUFFER Read a buffer of data 

Fi4 TRM_ BUFFER Read a buffer of data, terminate on 


specified condition 
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Serial Port Driver Function Definitions 


All of the following functions range check (between 0 and 3 inclusive) the requested port number 


specified in the DX register. If legal, the function looks up the I/O address contained in the STD-BIOS 
data area. If the port table entry is non-zero, the port is assumed to exist. If the port table entry is zero 
the function returns without altering any registers. 


Fi4__ INIT (AH = OOH) 


The initialize function, F14_ INIT, sets the baud rate, number of stop bits, parity and character length of 


the specified serial port. On return it reports the current contents of the line status register and the 
modem status register of the specified port. 


On Entry: AH 
AL 


Bit Data 


O7H-O5H 111 
110 
101 
100 
011 
010 
001 
000 

O4H-03H x0 


02H 0 


O1H-OOH 00 


F14_ INIT (00H) 
Port attribute 


Definition 


9600 baud rate 

4800 baud rate 

2400 baud rate 

1200 baud rate 

600 baud rate 

300 baud rate 

150 baud rate 

110 baud rate 

no parity 

even parity 

odd parity 

stop bit 

stop bits 
bits a Oe) 
bits | iC) OS 
bit character | ft 

bit character 


Oana uN — 


DX = Port number (0, 1, 2, 3) 


On Exit: AH = Line status (see Table 6-5) 
AL = Modem status (see Table 6-6) 


Registers Altered: AX 


Table 6-5 defines the Serial Port Line Status. 
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Table 6-5. Line Status Register Report 


Timeout Error (Not applicable on F14_INIT, F14_EXINIT or 
F14_ STATUS) 

Transmit Shift Register Empty 

Transmit Hold Register Empty 


Break Received 
Character Framing Error 
Parity Error 

Overrun Error 

Data Set Ready 





Table 6-6 defines the Serial Port Modem Status. 


7 
6 
5 
4 
3 
2 
1 
0 


Example: 


6-6 


MOV AH, F14_INIT 
MOV AL, Mapayite 


MOV DX, 0 
INT INT _SERTAL 
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Table 6-6. Modem Status Register Report 


Receive Line Signal Detected 
Ring Indicator Line State 

Data Set Ready Line State 

Clear to Send Line State 

Change in Receive Line Detected 
Trailing Edge of Ring Detected 
Change in Data Set Ready 
Change in Clear to Send State 





(AH = OH) 

HP LaserJet factory default 
9600 baud 

No parity 

2 stop bits 

8 bit character 

setting 

Port 0 specification 

Call serial driver (INT 14H) 


F14_ STATUS (AH = 03H) 
This subfunction returns the status of the serial port specified by the DX register. | 


On Entry: AH = F14 STATUS (03H) 
DX = Port number (0, 1, 2, 3) 


On Exit: AH = Line status (see Table 6-5) 
AL = Modem status (see Table 6-6) 


Registers Altered: AX 


F14__INQUIRE (AX = 6FOOH) 


This function determines whether or not the extended EX-BIOS functions are available. If the EX-BIOS 
functions are available, the BX register will be set to 4850H (which represents the ASCII characters 
*HP’). 


On Entry: AX 
BX 


F14 INQUIRE (6FO0H) 
Any value except 4850H (“HP”) 


On Exit: BX = ‘HP’ 
Registers Altered: AX, BX 
Example: 


MOV AX, F14 INQUIRE 

XOR BX, BX 

INT INT SERIAL 

CMP BX, ‘HP’ 

JNE short ERROR _NO EXTENDED FUNCTIONS 


(AH = 6FOOH) 

Clear out BX 

Call serial driver (INT 14H) 
Check? 


we we we we 
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F14__EXINIT (AX = 6FO1H) 


This function is similar to the STD-BIOS function, F14_ INIT, but provides the ability to set a baud rate 
beyond 9600. 


On Entry: AX = F14 EXINIT (6F01H) 
BX = Port attributes 
Bit Data Definition 


O8H-05H 1000 19200 baud rate 
0111 9600 baud rate 
0110 4800 baud rate 
0101 2400 baud rate 
0100 1200 baud rate 
0011 600 baud rate 
0010 300 baud rate 
0001 150 baud rate 
0000 110 baud rate 
O4H-03H xO no parity 
11 even parity 
01 odd parity 
02H 0 1 stop bit 
1 2 stop bits 
01H-OOH 00 undef ined 
01 undef ined 
10 7 bit character 
11 8 bit character 


DX = Port number (0, 1, 2, 3) 


Line status (see Table 6-5) 
Modem status (see Table 6-6) 


On Exit: AH 
AL 


Registers Altered: AX 


7 bit character 
Port 1 specification 
Call serial driver (INT 14H) 


MOV DXx,1 
INT INT SERIAL 


Example: 
MOV AX, F14 EXINIT ; (AH = 6FOTH) 
MOV BX, 0000000100011010B ; Port attributes 
; 19.2 K baud 
3 parity even 
3; 1 stop bit 
3 
3 
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For each byte, the signal DATA~-TERMINAL-READY is enabled in the modem control register indicating 
to the remote device that data can be sent. The modem status register signal DATA-SET-READY and the 
line status register signal DATA-READY are polled until a data byte is available to read or the timeout 
count has expired. After the data byte is read, it is inspected to see if it lies between the two boundary 
bytes. If the byte is in between the two bytes, then the transfer is terminated. This function is useful for 
transferring logical records. 


On Entry: AX = F14 TRM BUFFER (6F04H) 
BL = lower bound of termination character 
BH = upper bound of termination character 
CX = maximum buffer size 
DX = Port number (0, 1, 2, 3) 
ES:DI = Pointer to a data buffer 


On Exit: AH = Line status (see Table 6-5) 


Normal Completion Full Transfer: 


AL = last byte read 
CX = Number of bytes transferred successfully 
ES:DI = Base of data buffer 


Normal Completion Terminate Character Detected: 


AL = last byte read (terminate byte) 
CX = Number of bytes transferred successfully 
ES:DI = Base of data buffer 


Error Completion (bit 7 of AH register non-zero): 


AL = 0, the null byte 
CX = Number of bytes transferred successfully 
ES:DI = pointer to next byte to be transferred 


Registers Altered: AX, CX, DI, ES 


Example: 

IN BUFFER DB 512 DUP (20H) 

END BUFFER: 

START: 
MOV AX, seg IN BUFFER ; set pointer to string 
MOV ES, AX . 


LEA DI, offset IN BUFFER 

MOV AX, F14_TRM BUFFER 

MOV CX, END BUFFER--IN BUFFER 
MOV DX, 0 

INT INT SERIAL 

TEST AH, 10000000B | 

JNZ short ERROR PUT STRING 


(AX =6F04H) 

length of character string 
Port 0 specification 

Call serial driver (INT 14H) 
test for errors 


we we Oe we we 


CMP AL, BL ; lower bound? 
JL NOT BETWEEN 
CMP AL, BH 3 upper bound? 


JG NOT BETWEEN 
NOT BETWEEN: 
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Parallel Port Driver (INT 17H) 


The parallel port driver provides several functions that support data transfer on the parallel ports and 
return status. These functions implement the features of the industry standard INT 17H driver and the 
EX-BIOS extended functions. The EX-BIOS functions implement features not found in the ncuatry 
standard functions, such as block (multi-byte) data transfer. 


Table 6-7 summarizes the Parallel Port Driver (INT 17H) functions. It is followed by a description of 
each function. 


Table 6-7. Parallel Port Driver Function Code Summary 


Function Function 
Value Equate . Definition 


INT_ PRINTER Printer 

F17_ PUT_CHAR Send printer one byte 

F17_ INIT Initialize printer port 

F17_ STATUS Get printer port status 

F17_ INQUIRE _ EX-BIOS present 
F17_PUT_BUFFER Write a buffer to printer port 






















Parallel Port Driver Function Definitions 


The following functions range check (between 0 and 3, inclusive) the requested port address specified in 
the DX register. If legal, the function looks up the I/O address contained in the STD-BIOS data area. If 
the port table entry is non-zero, the port is assumed to exist. If the port table entry is zero, the function 
returns without altering any registers. 


F17__PUT__CHAR (AH = 00H) 


This function prints a character on the parallel port. Valid data is set up on the printer interface for at 
least 900 nanoseconds. If the BUSY signal indicates that the device is busy, it executes an INT ISH 
function F15_DEV_BUSY. When it returns from F15_ DEV_ BUSY, the function waits until the BUSY 
signal indicates the device is not busy. The function generates a 500 nanosecond data strobe and holds the 
data valid for at least 900 nanoseconds. The function returns with the port status in the AH register. 


On Entry: AH 
AL 
DX 


F17_ PUT_CHAR (00H) 
Data byte to be transmitted 
Port number (0, 1, 2, 3) 


On Exit: AH = Printer port status (see Table 6-8) 
Registers Altered: AH 


Table 6-8 defines the parallel printer port status byte. 
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Fi7 STATUS (AH = 02H) 
This function returns the status of the specified parallel printer port. 


On Entry: AH 
DX 


F17_ STATUS (02H ) 
Port number (0, 1, 2, 3) 


uo 


On Exit: AH = Printer port status 


Registers Altered: AH 


F17 INQUIRE (AX = 6FOOH) 


This subfunction determines whether or not the extended EX-BIOS functions are available. If the 
EX~-BIOS functions are available, the BX register will be set to 4850H (which represent the ASCII 
characters HP’). 


On Entry: AX 
BX 


F17 INQUIRE (6FOOH) 
Any value except 4850H (“HP’) 


On Exit: BX = ‘HP’ 


Registers Altered: AX, BX 


Example: 
MOV AX, F17_ INQUIRE ; (AX = 6FOOH) 
XOR BX,BX ; Clear out BX 
INT INT PRINTER 3; Call printer driver (INT 17H) 
CMP BX, HP’ 3 Check? 


JNE short ERROR_NO EXTENDED FUNCTIONS 


F17_ PUT_ BUFFER (AX = 6F02H) 


This function transmits data from a buffer as long as there is data in the buffer and no error is 
encountered. Valid data is set up on the printer interface for at least 900 nanoseconds. If the BUSY signal 
indicates that the device is busy, it executes an INT 15H function F15_ DEV_ BUSY. When it returns 
from Fi5_DEV_ BUSY, the function waits until the BUSY signal indicates the device is not busy. The 
function generates a 500 nanosecond data strobe and holds the data valid for at least 900 nanoseconds. 
The function returns with the port status in the AH register. 


On Entry: AX F17 PUT BUFFER (6F02H) 


CX Number of characters in the data buffer 
DX = Port number (0, 1, 2, 3) 
ES:DI = 


Pointer to a data buffer of characters 


On Exit: AH = Printer port status 
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Normal Completion: 
CX Number of bytes transferred successfully 
ES:DI Base of data buffer 


Error Completion (bit 0 of AH register non-zero): 
CX = Number of bytes transferred successfully 
ES:DI = pointer to next byte to be transferred 


Registers Altered: AH, CX, DI, ES 


Example: 
STRING DB ‘Hello’ 
END STRING: 
START: 
MOV AX, seg STRING 3; set pointer to string 
MOV ES, AX 
MOV DI, offset STRING 
MOV AX, F17_ PUT BUFFER 3; (AX = 6FO2H) 
MOV CX, END STRING-STRING length of character string 
MOV DX, O Port O specification 


INT INT PRINTER 
TEST AH, 00000001B 
JNZ short ERROR_PUT_ STRING 


Call printer driver (INT 17H) 
test for errors 


we we we we we 


Print Screen Driver (INT 05H) 


The print screen driver prints the contents of the screen. Each time an INT 05H instruction is executed, 
the contents of the screen will be printed on the system printer (Port 0). If a print screen operation is 
already in progress the driver returns without printing the contents of the screen. The print screen driver 
does not execute functions in the same manner as the other drivers. It performs a single task, and so there 
are no functions. 


The print screen driver is called by the keyboard driver (INT 9H) when the scancode (O6AH) for the 
<Print Screen> key is detected. In addition, application programs may execute an INT 05H instruction 


any time a copy of the contents of the screen is desired. 


The print screen driver can only print the contents of a screen if the display adapter is in one of its 
alphanumeric modes. 


6-16 Serial and Parallel {/O 


Disc 





This chapter discusses the ROM BIOS disc drivers. The disc driver (INT 13H) provides a set of functions 
that control the disc drives and data transfer between the disc drives and the system. 


Overview 


The disc driver supports four disc types: standard capacity 5.25-inch flexible discs (360 KB), 
high-capacity flexible discs (1.2 MB), high capacity 3.5-inch discs (1.44 MB) and hard discs. The 
structure of the disc driver allows additional drives to be easily integrated into the system. 


Physical Drive Numbers 


Each drive in the system has a physical drive number. Physical drive numbers for flexible discs start with 
0, while physical drive numbers for the hard disc start with 80H. In a typical system configured with one 
high-capacity flexible disc drive, one standard capacity flexible disc drive, and two hard disc drives, the 
physical drive numbers would be 0, 1, 80H and 81H respectively. 


Flexible Disc Drive Support 


The disc driver provides support for both standard and high-capacity flexible disc drives. The disc driver 
supports dual format operation (i.e., reading and writing both types of flexible discs) in the high-capacity 
disc drive(s). The flexible disc drives are supported with eleven functions that perform read, write, verify, 
reset, format, and return status tasks. 


Hard Disc Drive Support 


The system can be configured with an optional hard disc drive. When an internal hard disc drive is added 
to the system, the disc driver is "expanded" to include the functions that support the hard disc. 


The hard disc BIOS is integrated into the system during SYSGEN (the System Generation process). Early 
in the SYSGEN process, the software interrupt INT 13H is initialized to point to the flexible disc driver 
code module. 


When an INT 13H is executed the hard disc code is called first. The hard disc code checks the physical 
drive number specified. If it is a hard disc drive number (greater than or equal to 80H) the function is 
executed by the hard disc driver code module. If the physical drive number indicates a flexible disc drive 
(less than 80H), the hard disc code module passes control to the flexible disc driver code module by 
executing an INT 40H. 
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External Disc Drives 


External disc drives can easily be added to the system. There are two methods for doing this. The external 
disc can supply BIOS code in an option ROM to enter the system. As an alternative, the system could use 
a DOS installable device driver. 


Discs using installable device drivers can not be used as boot devices, since they are loaded in RAM by the 
operating system. Further, operating systems other than DOS may not recognize the disc in the system. 
For more information on installable device drivers consult the Vectra MS-DOS Programmer's Reference 
Manual. 


Using the option ROM entry mechanism described in the following section, the external hard disc becomes 
an integrated part of the system and is treated as if it were an internal drive. The first physical hard disc 
drive, 80H, can then be used as the system boot device. 


Data Structures 


There are separate data structures for the hard disc and the flexible disc drivers. The flexible disc has 
three data structures. The flexible disc parameter table holds information necessary for initializing and 
supporting the flexible disc controller chip. The flexible disc status table holds information about the 
status of the previous flexible disc operation. The flexible disc operation table contains various disc 
operating parameters such as drive status, flexible disc data transfer rate, etc. The hard disc has only one 
data structure. However, each hard disc driver maintains its own copy. The hard disc parameter table is 
similar to the flexible disc status table. It contains the physical device characteristics for a particular hard 
disc attached to the system. 


Flexible Disc Operation Table 


The flexible disc operation table is located in the STD-BIOS data area starting at memory location 
0040:008BH (0048BH). It contains parameters used by the disc driver to perform its functions. Data 
stored in this table allow the high-capacity drives to read or write either standard or high-capacity 
flexible discs. The contents of the operating parameter table are listed in Table 7-1. For the Vectra RS 
system only, support for two additional flexible discs is achieved with a special Flexible Disc Expander 
card. (If this card is installed, the contents of the operation table are expanded.) See Tables 7-1 and 
7-1a. 


Table 7-1. Flexible Disc Operation Table 


Description 


Data transfer rate of previous operation 

Drive indicators 

Current media type table for drives 0 and 1 

Work area to generate current media types for drives 0 and 1 


Table of current head positions for drives 0 and 1 





7-2 Disc 





For Vectra RS systems with a Flexible Disc Expander card installed, the operation table is expanded to 


include the following: 


Table 7-la. Expanded Flexible Disc Operation Table 


Description 


Drive indicators for drive 2 and 3 


Current media for drives 2 and 3 


Work area to generate current media types for drives 2 and 3 


Table of current head positions for drives 2 and 3 





Flexible Disc Parameter Table 


The flexible disc parameter table contains information that controls the overall operation of the flexible 
disc controller. This table is pointed to by INT !EH (0:78H). The parameters used to control the flexible 
disc controller can be changed by providing a new flexible disc parameter table pointer in INT LEH 
(0:78H). This is detailed in Table 7-2. 


Length 
Offset in Bytes 


00H 





Table 7-2. Flexible Disc Parameter Table 


Description 


anenat 


Specify command byte 1: step-rate time and head unload time 





eects. 


Specify command byte 2: head load time and DMA (Direct Memory 
Access) mode 


Motor wait time 

Bytes per sector; 09128, 1#256, 22512, 3=1024 
Last sector number on track 

Read/write gap length between sectors 

Data length for read/write operations 


Format gap length between sectors 
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Table 7-2. Flexible Disc Parameter Table (Cont.) 


Length 
in Bytes Description 


Format filler byte 


Head settle time after seek command 





Motor start time in seconds (1/8 second or 125 ms) 


Flexible Disc Status Table 


The status table for the internal flexible disc driver begins at memory location 0040:003EH (0043EH) in 
the STD-BIOS Data Area. The contents of this table are listed in Table 7-3. 


Table 7-3. Flexible Disc Status Table 


Flag byte 
Motor status 
Motor turn off counter 


Status of previous flexible disc operation — 


Status bytes returned by the flexible disc controller from the 
previous operation 
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Hard Disc Parameter Table 


The hard disc drive has a set of parameters which are quite different from the flexible disc. Therefore, 
the contents of the hard disc parameter table are not the same as its flexible disc counterpart. 


Interrupt vector 41H contains the address of the first hard disc table while interrupt vector 46H stores 
the address of the second hard disc table. The contents of the tables are listed in Table 7-4. 


- Table 7-4, Hard Disc Parameter Table 


Total number of cylinders 


Total number of Read/Write Heads 


Reserved 

Starting cylinder for write precompensation 
Reserved 

Cylinder to use as landing zone 

Number of sectors per track 


Reserved 
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Disc Driver (INT 13H) 


The description of this driver is in two parts: the flexible disc driver functions, and hard disc driver 


functions. 


INT 13H Flexible Disc Driver Functions 


Table 7-5 lists each of the INT 13H driver flexible disc functions. All registers not specified in the exit 
parameters are returned unchanged. 


Function 
AH 


OOH 





Table 7-5. Flexible Disc Driver Function Code Summary 


1 Ae PH ETE PPO REAL AERA ROS HE TE SN BRANT ER HER ANY NO ROSE IH AOEROON. SE 8.BeSr . 


Definition 


Reset flexible disc subsystem 

Get status from last operation 

Read sectors from flexible disc 

Write sectors to flexible disc 

Read verify sectors on flexible disc 

Format a track on flexible disc 

Reserved 

Get drive parameters 

Reserved 
Get DASD (Direct Access Storage Device) type 
Get disc change line status 

Set DASD type for format 

Set media type for format 


The the status byte returned in AH for the following functions has the following meaning. For the 
majority of the functions, the carry flag will be set when AH 1s non-zero: 


AH Meaning 

OOH No errors. 

O1H Bad command. 

02H Address mark not found. 
03H Attempt to write on a write protected diskette. 
Q4H Sector not found. 

OGH Media changed. 

08H DMA overrun. 

OSH 64K boundary violation. 
OCH Media type not found. 
10H Bad CRC detected. 

20H Controller failure. 

40H Seek failure. 

80H Time out. 
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Flexible Disc Driver Function Definitions 


Reset Flexible Disc Subsystem (AH = 00H) 
Entry AH OOH 


Exit AH Status. 


Get Status of Last Operation (AH = 01H) 
Entry AH O1H 


Exit AH Status. 


Read Sectors from Flexible Disc (AH = 02H) 


Entry AH 02H . 
AL Number of sectors to read. (Note 1) 
CL Starting sector number. (Note 2) 
CH Cylinder number. (see Note 3) 
DL Drive number (0 - 3). 
DH Head number (0 or 1). 
ES: BX Buffer address. 
Exit AH Status. 
AL Number of sectors actually read. 


Write Sector to Flexible Disc (AH = 03H) 


Entry AH 03H 
AL Number of sectors to write (Note 1) 
CL Starting sector number. (Note 2) 
CH Cylinder number. (Note 3) 
DL Drive number (0 - 3). 
DH Head number (0 or 1). 
ES : BX Buffer address. 
Exit AH Status. 
AL Number of sectors actually written. 
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Read Verify Sectors on Flexible Disc (AH = 04H) 


Entry AH 04H 
AL Number of sectors to read verify. (Note 1) 
CL Starting sector number. (Note 2) 
CH Cylinder number. (Note 3) 
DL Drive number (0 - 3). 
DH Head number (0 or 1). 
Exit AH Status. 
AL Number of sectors actually verified. 


Format Track (AH = 05H) 


Entry AH OSH 
AL Sectors per track. 
CH Cylinder number. (Note 3) 
DL Drive number (0 - 3). 
DH Head number (0 or 1). 


ES:BX Points to a 512 byte buffer containing a table 
of address fields for the track (C, H, R, N). 
Where C is the cylinder number, H is the head 
number, R is the record number and N is the 
number of bytes per sector (0=128, 1=256, 
2=512, 3=1024). There should be as many entries 
as there are sectors on the track. 


For example, to format track 5 head 0 with 9 sectors of 512 bytes each and an interleave factor of 1 the 
table would look like: 


: C H R N ;Position in track 

DB OSH, OOH, O1H, O2H j;1st. 

DB OSH, OOH, O2H, O2H ;2nd. 

DB OSH, OOH, O3H, O2H 33rd. 

DB OSH, OOH, O4H, O2H 34th. ij 
DB O5H, OOH, OSH, O2H = ;5th. 

DB OSH, OOH, O6H, O2H ;6th. 

DB OSH, OOH, O7H, O2H = ;7th. 

DB OSH, OOH, O8H, O2H = ;8th. 

DB OSH, OOH, OSH, O2H ;9th. 


The number of sectors per track argument (AL) should be set as follows: 


Drive Media AL 
360 320/360 8/9 
1.2 320/360 8/9 
1.2 1.2 15 
720 720 9 
1.44 1.44 18 


If the drive can support more than one media type, 1.2 MB for example, then the diskette will be 
formatted with the lasrgest possible capacity. Use INT 13H, function 17H "Set DASD type" and 18H "Set 
media type" to set the diskette type to be formatted. 


7-8 Disc 





The following parameters in the flexible disc parameter table must be changed before formatting the 
corresponding media: 


Media Drive GPL EOT 

320K 360K/1.2MB SOH 8 

360K 360K/1.2MB 50H 9 

1.2MB 1.2MB 54H 15 

720K 1.2MB/1.44MB 50H 9 

1.44MB 1.44MB 6CH 18 

Where: 

GPL Gap Length for format. 

EOT End Of Track (Last sector on track). 


Absoulte address 0:78H contains a pointer to the flexible disc parameter table. GPL is the 8th byte in the 
table and the EOT is the Sth. 


The original parameters must be restored after format is complete. 


Get Drive Parameters (AH = 08H) 


Entry AH 08H 
DL Drive number (0 - 3). 
Exit AX 0 
CL Sectors per track. 
CH Total number of cylinders. 
OL Number of flexible discs in system. 
BL Drive type as stored in CMOS. 


ES: DI Address of drive parameter table. 


In case of errors such as calling the function with an invalid drive number or the drive type is not known 
and CMOS is not valid then AX,BX,CX,DX,DI and ES will be set to 0. 


Get DASD Type (AH = 15H) 


Entry AH 15H 
DL Drive number (0 - 3). 
Exit AH 0 = Drive not installed. 
1 = Drive installed, change line not available. 
2 = Drive installed, change line available. 
3 = Reserved 


AH is valid only if carry flag is cleared (no errors). 
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Get Disc Change Line Status (AH = 16H) 


Entry AH 16H 
DL Drive number (0 - 3). 
Exit AH 0 Disc change line not active. 


6 Disc change line active. 


Set DASD Type for Format (AH = 17H) 


Entry AH 17H 
AL DASD type to set to: . 
1 320K/360K media in 360K drive. 


2 = 360K media in 1.2MB drive. 

3 = 1.2MB media in 1.2MB drive. 

4 = 720K media in 720K drive. 
DL Drive number (0 - 3). 


Exit None. 


Set Media Type for Format (AH = 18H) 


Entry AH 18H 
CL Sectors per track. 
CH Total number of cylinders. 
DL Drive number (0 - 3). 


Exit ES:DI Address of drive parameters table for this 
Sector per track/Cylinders combination if 
carry is clear otherwise ES:DI is same as 
was on entry. 


AH 00h = Sectors per track/Cylinders combination 
is supported and the ES:DI pointer is valid. 
Olh = This funciton is not available. 
OCh = Sectors per track/Cylinders combination 


is not supported. 


Note 1: Number of sectors (AL): 


Drive Media AL 
360 320/360 1-8/9 
1.2 320/360 1-8/9 
1.2 1.2 1-15 
720 720 1-9 
1.44 1.44 1-18 


7-10 Disc 





Note 2: Sector Number (CL): 


Drive Media 
360 320/360 
1.2 320/360 
122 1.2 

720 720 
1.44 1.44 


Note 3: Cylinder number (CH): 


Drive Media 
360 320/360 
1.2 320/360 
1.2 1.2 

720 720 
1.44 1.44 


AL 
1-8/9 
1-8/9 
1-15 
1-9 
1-18 


CH 

0-39 
0-39 
0-79 
0-79 
0-79 
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Table 7-6. Hard Disc Driver Functions 


Reset hard disc and flexible disc subsystem 
Get status from last operation 


Function 
(AH) 





Read sectors from hard disc 
Write sectors to hard disc 







Format a track on hard disc 
Reserved 

Get drive parameters 
Set drive parameters 
Read long 

Write long 

Seek 

Alternate hard disc reset 
Reserved 

| Get drive ready status 
Recalibrate drive 
Reserved 
















Get DASD type 





Read verify sectors on hard disc 


Perform controller diagnostics 






The status byte returned in AH for the following functions has the following meaning. For the majority 
of the functions, the carry flag will be set when AH is non-zero: 


AH Meaning 

OOH No errors. 

O1H Bad command. 

02H Address mark not found. 

04H Sector not found. 

OSH Reset failure. 

OTH Set drive parameters failure. 

OSH 64K boundary violation on transfer size. 
OAH Bad block flag detected. ; 
10H Bad ECC detected. 

11H Data was corrected. 

20H Controller failure. 

40H Seek failure. 

80H Time out. 

AAH Drive not ready. 

BBH undefined error occured. 

CCH Write fault. 


Hard Disc Driver Function Definitions 


Reset Hard and Flexible Disc Subsystem (AH = 00H) 


Entry AH OOH 
DL Drive number (80H = C:, 81H = D:) 
Exit AH Status. 


Get Status of Last Operation (AH = 01H) 
Entry AH O1H 


Exit AH Status. 
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Read Sectors from Hard Disc (AH = 02H) 


Entry 


Exit 


AH 
AL 
CL 


CH 
DL 
DH 
ES: BX 


AH 


02H 

Number of sectors to read. (1-80H) 

Low order 6 bits of CL is the starting 

sector number. (1-63) 

CH will be combined with the high order 2 bits 
from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

Drive number (80H = C: or 81H = D:). 

Head number. (0-15) 

Buffer address. 


Status. 


Write Sector to Hard Disc (AH = 03H) 


Entry 


Exit 


AH 
AL 
CL 


CH 
DL 
DH 
ES : BX 


AH 


03H 

Number of sectors to write (1-80H) 

Low order 6 bits of CL is the starting 

sector number. (1-63) 

CH will be combined with the high order 2 bits 
from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

Drive number (80H = C: or 81H = D:). 

Head number. (0-15) 

Buffer address. 


Status. 


Read Verify Sectors on Hard Disc (AH = 04H) 


Entry 


Exit 


AH 
AL 
CL 
CH 
DL 
DH 


AH 


04H 

Number of sectors to read verify. (1-80H) 

Low order 6 bits of CL is the starting 

sector number. (1-63) 

CH will be combined with the high order 2 bits 
from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

Drive number (80H = C: or 81H = D:). 

Head number. (0-15) 


Status. 
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Format Track (AH = 05H) 


Entry AH OSH 
AL Sectors per track. 
CH CH will be combined with the high order 2 bits 


from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

DL Drive number (80H = C: or 81H = D:). 

DH Head number. (0-15) 

ES: BX Pointer to an interleave table for the track. 


For every sector on the track there are two bytes in the table that describe the sector. The first byte is a 
flag byte that is set to 80H if the sector is to be marked as a bad block otherwise the flag is set to 0. The 
second byte is the sector number to be given to the sector that this table entry is describing. For example, 
a table for a track of 17 sectors with interleave factor of 2 and no bad blocks would look like: 


: Flag Sector Position in track. 
DB OOh, O1H sist. 
DB OOh, OAH 3end. 
DB OOH, O2H 33rd. 
DB OOH, OBH 34th. 
DB OOH, 03H 35th. 
DB OOH, OCH 36th. 
DB OOH, 04H 37th. 
DB OOH, ODH 38th. 
DB OOH, OSH 39th. 
DB OOH, OEH 310th. 
DB OOH, O6H 311th. 
DB OOH, OFH . 312th. 
DB OOH, O7H 313th. 
DB OOH, 10H 314th. 
DB OOH, O8H 315th. 
DB OOH, 11H 316th. 
DB OOH, O9H 317th. 


Get Drive Parameters (AH = 08H) 


Entry AH 08H 
DL Drive number (80H = C:, 81H = D:). 
Exit AX 0 
CL Low order 6 bits is the number of sectors 


per track. High order 2 bits are high order 
bits of total number of cylinders. 
CH Low order 8 bits of cylinder number. 
CH will be combined with the high order 
2 bits from CL to form a 10 bit cylinder number. 
-DL Number of discs in system. 
DH Maximum head number. 
ES:DI Address of drive parameter table. 
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Set Drive Parameters (AH = 08H) 


Entry AH O8H 
DL Drive number (80H = C:, 81H = D:). 
Exit AH Status. 


The drive parameters are intialized from 
the drive parameters pointed to by INT 41H 
vector for drive C: and INT 46H vector for 
drive D:. 


Read Sectors and ECC from Hard Disc (Read Long) (AH = OAH) 


Entry AH OAH 
AL Number of sectors to read. (1-7FH) 
CL Low order 6 bits of CL is the starting 
sector number. (1-63) 
CH CH will be combined with the high order 2 bits 


from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

DL Drive number (80H = C: or 81H = D:). 

DH Head number. (0-15) 

ES; BX Buffer address. 


Exit AH Status. 


The read long operation will transfer 512 bytes of data followed by 4 bytes of ECC for each sector. 


Write Sectors and ECC to Hard Disc (Write Long) (AH = OBH) 


Entry AH OBH 
AL Number of sectors to write. (1-7FH) 
CL Low order 6 bits of CL is the starting 
sector number. (1-63) 
CH CH will be combined with the high order 2 bits 


from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 

DL Drive number (80H = C: or 81H = D:). 

DH Head number. (0-15) 

ES: BX Buffer address. 


Exit AH Status. 


The write long operation will transfer $12 bytes of data followed by 4 bytes of ECC for each sector. 
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Seek to Specified Cylinder (AH = OCH) 


Entry AH OCH 
CL High order 2 bits are high order 2 bits of 
the cylinder number. 
CH CH will be combined with the high order 2 bits 


from CL to form a 10 bit cylinder number with 
CH being the low order 8 bits. (0-1023) 
DL Drive number (80H = C: or 81H = D:). 


Exit AH Status. 


Aiternate Disc Reset (AH = ODH) 


Entry AH ODH 
Di Drive number (80H = C: or 81H = D:). 
Exit AH Status. 


The alternate disc reset function is the same as function 00H except that the flexible disc subsystem is 
not affected. 


Test Drive Ready (AH = 10H) 


Entry AH 10H 

DL Drive number (80H = C: or 81H = D:). 
Exit AH Status. 
Recalibrate Drive (AH = 11H) 
Entry AH 11H 

DL Drive number (80H = C: or 81H = D:). 
Exit AH Status. 


Controller Diagnostics (AH = 14H) 
Entry AH 14H 


Exit AH Status. 
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Get DASD Type (AH = 15H) 


Entry AH 15H 
DL Drive number (80H = C: or 81H = D:). 
Exit AH 0, Not present. 
1, Flexible disc, change line not available. 
2, Flexible disc with change line. 
3, Hard disc. CX:DX is the number of 512 


byte sectors on the media. 


Disc 
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System Drivers 





This chapter contains a description of the drivers which control the system functions. The drivers 
discussed in previous chapters deal with system peripherals such as the disc drives, keyboard, video display 
adapter, etc. The drivers covered in this chapter control the system itself. 


Overview 


The system drivers are designed to provide program access to system operating parameters and to support 
ROM BIOS drivers. These drivers allow programs to determine the system equipment configuration and 
amount of memory, provide "hooks" for future multi-tasking capability, control vectors in the 

HP VECTOR_ TABLE, allocate RAM in the EX-BIOS data area, control system strings, manage CMOS 
memory, and perform system clock functions. An overview of the capabilities of the drivers in each of 
these categories follows. 


Memory Size And Equipment Determination 


The ROM BIOS supports two industry standard drivers that report the current system equipment 
configuration and memory size. These tasks are supported by the INT 11H and INT 12H drivers, 
respectively. 


The equipment determination driver (INT 11H) returns a word (double word on Vectra QS and RS series) 
that describes the current system configuration. The definition of each bit or group of bits in the word is 
discussed later in this chapter. The number of printer ports, serial ports, presence of a math coprocessor 
(80287 or 80387), presence of Weitek math coprocessor (Vectra RS series only), initial video display 
mode and number of flexible disc drives are reported by this driver. The default system configuration 1s 
read from a CMOS memory location during power-on. If this information does not match the current 
configuration, a power-on error message is issued and the current configuration is saved for the INT 11H 
driver. 


The memory size driver (INT 12H) returns a word that indicates the number of 1 KB blocks of system 
RAM present. The amount of memory reported does not include any extended memory, and is adjusted to 
exclude the amount of RAM occupied by the EX-BIOS data area. For example, in a system equipped with 
640 KB of system RAM using a 4 KB EX-BIOS data area, the amount of memory reported by this driver 
will be 636 KB. The default amount of memory is read from a word of CMOS memory. 
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Extended System Support 


The extended system support driver (INT 15H) provides support for several advanced system features. It 
provides "hooks" that allow programs to be written to support multi-tasking at a future date. In addition, 
it allows data to be transferred to and from extended memory, and allows placing the CPU into its 
protected mode of operation. 


-EX-BIOS Driver Support 


The V_SYSTEM driver is an EX-BIOS driver that provides support tasks for the EX-BIOS drivers. It 
contains functions that allocate RAM in the EX-BIOS data area and manipulate HP_VECTOR_ TABLE 
entries. 


RAM Allocation 


The EX-BIOS data area contains three major data structures: the HP VECTOR_ TABLE, the global data 
area, and the driver’s data area. Within each driver’s data area is the driver header, describe record (if 
applicable), and variable storage area. Each entry in the HP_VECTOR_ TABLE is three words long and 
consists of: Driver’s IP, CS, and DS in that order. The HP_ENTRY_ CODE (default INT 6FH) loads the 
appropriate driver’s data segment DS and Jumps to the address CS:IP. 


The global data area is used by system drivers that need to share data. Data structures like the EX-~BIOS 
stack and memory management pointers are maintained here. 


The driver data area for each driver is dynamically allocated by the V_ SYSTEM driver. Each driver’s 
data area is at its data segment (DS) and is generally composed of a standard header followed by any data 
particular to the driver. If the driver wishes a data area from the EX-BIOS memory it must follow the 
allocation process described below. 


Space is allocated starting from the base of the global data area toward the top of the 

HP_VECTOR_ TABLE as shown in Figure 8-1. When a driver is initialized, the base address of the last 
driver data area ("last used DS") is passed to the driver. The driver decrements this value by the number 
of paragraphs (16 bytes) it needs for its data area, then returns this value as the new "last used DS". 
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HP_VECTOR_TABLE 


oe ENIAYS cS0 HP_VECTOR_TABLE 


HP_ENTRY_CODE 


HP_ENTRY_CODE 
HP_ENTRY's CS:IP 





"Max DS" 
EX-BIOS 
Memory 
Pool EX-BIOS 
“Last used DS" Memory 
Pool 






EX-BIOS Resident 
Driver's Data 
Segments 







V_SYSTEM's DS 






EX-BIOS Global 
Data Segment 





TOP of RAM 


Figure 8-1. Driver Data Area Allocation 


If a driver needs a particularly large data area, there might not be enough room. The driver must: 
determine the amount of RAM it requires, then see if that amount is available by comparing its 
requirements against the amount of RAM available ("last used DS" - "Max DS"). 


If there is an insufficient amount of RAM available, the driver may increase the amount of RAM 
allocated to the EX-BIOS data area in the following manner. The memory size stored in CMOS RAM is 
the amount of physical RAM less the amount occupied by the EX-BIOS Data Area. When the system is 
booted, the boot code determines the amount of physical memory, then subtracts the "top of memory" 
stored in CMOS RAM to determine how much space to allocate for the EX-BIOS Data Area. Adjusting 
the memory size in CMOS RAM downward, then rebooting, will increase the size of the EX-BIOS Data 
Area and hence the amount of RAM available to the driver. This technique may be used to create an 
EX-BIOS data area up to 64 KBytes in size. A program listing demonstrating this process follows. 
(Functions F_RAM_GET, F_RAM_RET, F_CMOS_GET and F_CMOS_RET are described in detail 
later in this chapter). 
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Example: 


we 


we 


MOV BP, V_SYSTEM 


MOV AH, F_RAM GET 
CALL SYSCALL 


DEC BX 
DEC BX 
DEC BX 


CMP BX, DX 
JA OK 


3 
NOT ENOUGH_RAM: 


we 


we 


woe 


MOV BL, 15H 

MOV AH, F_CMOS GET 
MOV BP, V_SYSTEM 
CALL SYSCALL 


DEC AL 


PUSHF 

MOV BL, 15H 

MOV AH, F_CMOS RET 
MOV BP, V_SYSTEM 
CALL SYSCALL 


POPF 
JNC RESET _PROCESSOR 


MOV BL, 16H 
MOV AH, F_CMOS GET 
MOV BP, V_SYSTEM 
CALL SYSCALL 

DEC AL 

MOV BL, 16H 

MOV AH, F_CMOS_RET 
MOV BP, V_SYSTEM 
CALL SYSCALL 


RESET PROCESSOR: 


JMP FAR PTR OFOOOH: OF FFOH 


we we we we we 


How much memory available in 
EX-BIOS data area? 
F_RAM GET returns: 

BX = "last used DS" 

DX = "Max DS" 


P Allocate 3 paragraphs (48 bytes) 


we 


application requires 44 bytes but 
must allocate in full paragraphs 


New "last used DS" - “Max DS” 


CMOS bytes 16H, 15H contain 
“top of memory’ value 
value (in 1 KB units) 


Get least significant byte 


Free up 1KB memory for 
EX-BIOS data area 


Store new “top of memory" in CMOS 


If necessary, decrement most 


significant byte 


Reboot system. 
This time with 1KB more memory 
allocated to the EX-BIOS data area 


° 
> 


OK: 
MOV BP, V_SYSTEM ; Set new “last used DS" and "Max DS" 
MOV AH, F_RAM_ RET ; Memory is allocated ; 
CALL SYSCALL 
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HP_VECTOR_TABLE Manipulation 


All drivers in the EX-BIOS code module are accessed through the HP_VECTOR_ TABLE. The 
V_SYSTEM driver provides a set of functions which allows the entries in the HP_VECTOR_TABLE to 
be set and/or modified. There are nine functions, which represent the permutations of three parameters. 


The first parameter determines whether a vector is to be inserted or exchanged with values passed in the 
CPU registers. Vectors are typically inserted into the HP_VECTOR_ TABLE during the boot process, 
whereas vector exchanges are used to implement driver mapping. For example, the V_QWERTY keyboard 
translator driver is installed in the HP_VECTOR_TABLE during the boot process. If keyboard scancodes 
from the QWERTY keypad were to be mapped to a Dvorak translator (Ki ), the IP, CS, 
and DS of the Dvorak translator driver would be exchanged with the existing vector (so the vector could 
be restored to its original value at a later time). 





The second parameter is the vector type. The HP_VECTOR_ TABLE has three types of vectors; fixed, 
reserved, and free. Fixed vectors are those assigned to the default EX-BIOS drivers. The first 51 vectors 
in the HP_ VECTOR_ TABLE are fixed. Reserved vectors are set aside for future expansion. There are 24 
reserved vectors, which are located at vector addresses 138H through 1C8H inclusive. Free vectors are 
provided to allow user-supplied drivers to be added to the system. 


The final parameter involves the Data Segment (DS) of the driver. Drivers may allocate their data areas 
from the EX-BIOS data area as explained above, they may provide their own, or use the global data area 
of the EX-BIOS. The EX-BIOS drivers all use the DS allocation functions, while an external driver (for 
example, one installed as an MS-DOS device driver) may supply their own data area external to the 
EX-BIOS data area. Drivers supplying their own DS must pass it as a parameter to V_SYSTEM when the 
driver has completed initialization. 


System String Control 


The EX-BIOS provides a centralized and flexible mechanism for accessing and using strings. Each string in 
the system has a unique index number associated with it. Drivers and application programs can request 
access to a string via these indices. In addition, functions are available to return the index of a given 
string, return the next available index, and to add and delete strings from the system. 


A string index may be any word value (0--OFFFFH). Certain ranges of indices have predefined meanings 
or uses. These predefined ranges are listed below. 


0--2K Any index in this range is reserved for string names of EX-BIOS drivers. 

2--4K This range is reserved for strings stored in the ROM-BIOS. 

4--32K This range should be used by application programs to add strings to the system. 
32--64K These indices are reserved for localized strings. Indices within this range are parti- 


tioned in the same way as in the lower 32K (i.e., 32--34K for string names of 
EX-BIOS drivers, etc.). 
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This index structure provides a powerful tool for localizing application programs. If an application 
program references messages as string indices, the program can easily be localized by loading a localized 
set of strings (using a device driver for example), and setting bit 15 of all string indices used. 


System strings are grouped into buckets. A bucket is a collection of strings which are grouped together. 
There is no fixed limit on the number of strings which may be stored in a bucket. However, strings are 
added and deleted in buckets, not individually. Therefore, strings that are likely to be added or deleted 
together should be stored in the same bucket. 


Each bucket consists of three separate data structures; the bucket header, bucket pointers, and the bucket 
itself. These components are illustrated in Figure 8-2. The function of each is described below: 


Bucket Header - The bucket header is the top level data structure. All bucket headers are linked together 
in a chain. The first two fields in the header contain the offset and segment of the next bucket header in 
the chain. If these fields both contain OFFFFH, then this bucket header is the last in the chain. The 
highest and lowest string indices contained in the bucket are stored in the next two fields. The following 
two fields contain the offset and segment of the bucket pointer. Finally, the last field contains the 
segment of the strings themselves. 


Bucket Pointer - The bucket pointer consists of a series of offsets to the strings in the bucket. There must 
be one offset for every index in the range specified in the bucket header. The actual address of the string 
is determined by the segment (which is stored in the bucket header) and the offset stored in the bucket 
pointer. Note that all strings in a bucket must be in the same segment. 


Bucket - The bucket contains the actual strings. Each string consists of a byte containing the number of 
characters in the string, the string itself, and a null byte (OOH) which serves as a string terminator. 


| String control is accomplished through the appropriate functions in the V_ SYSTEM driver. These 


functions provide complete control over system strings. 


BUCKET BUCKET 
dearobeees HEADER #1 POINTER 












STR_NXT_HDRA (OFFSET) 


STR_NXT_HDA (SEGMENT) i 
STR_UPPER_BOUND 


DOUBLE WORD 











WORD 
WORD 


STR_LOWER_BOUND 


STR_LIST_PTR (OFFSET) 


STR_LIST_PTR (SEGMENT) 4 


DOUBLE WORD 


WORD 






BUCKET 
HEADER #2 
















STR_SEGMENT: PTR 1 BUCKET 
BrTe 
ere [ounn | 
ere [own | 
ore 
ere [ounne 
erre 
ovre 
prre 
one [oun | 


STRING TERMINATOR 00H 


Figure 8-2. System String Data Structures 
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CMOS Memory Controi 


The system contains a CMOS Memory/Clock chip that serves as a real-time clock and provides 128 bytes 
of non-volatile memory storage. The CMOS RAM is used to store system parameters. The contents of the 
CMOS RAM are listed in Appendix C. 


The CMOS Memory/Clock is accessed through two I/O ports. One port selects the clock register or 
memory byte to access, and the other is a bidirectional data port. There are a total of 128 addresses in 
the CMOS Memory/Clock chip; the first 14 are the clock registers, while the remaining 114 are the 
CMOS RAM. 


The V_ SYSTEM driver contains two functions which support reading and writing data to the CMOS 
Memory/Clock. These functions provide a simple access to the contents of the chip. 


System Clock Functions 


The system employs two separate clock systems to keep track of the time and date. The first is the CMOS 
Memory/Clock. The CMOS clock has a battery back-up which allows it to keep track of the current 
time when the system is turned off. 


The second clock is a software clock. It uses Channel 1 of the 8254 counter/timer chip (refer to the 
Vectra Hardware Technical Reference Manual for additional details). Channel | of the 8254 generates a 
hardware interrupt (IRQ 0) approximately 18.2 times per second. The ROM BIOS keeps time by 
incrementing a software clock each time the interrupt occurs. The software clock is used by the operating 
system for such tasks as time and date stamping of files. 


The two clocks operate independently except at boot time. During the boot process, the current time and 
date maintained by the CMOS clock is read and used to initialize the software clock. Changing the value 
of CMOS clock will not affect the software clock until the system is rebooted. 


The STD-BIOS clock driver (INT 1AH) provides a convenient way to read or set the time and date from 
either of the system clocks. These functions are detailed later in this chapter. 


In addition to keeping time, both clocks issue interrupts that call user or application program routines. 
The software clock interrupt service routine performs an INT 1CH each clock tick. If this vector 1s 
modified to point to a user routine, the routine will be called on each clock tick. 


The CMOS clock has an "alarm clock" feature. It can be programmed to issue an interrupt at a specified 
time. The real-time clock hardware issues an INT 4AH each time the alarm timer is done. The interrupt 
4AH vector can be modified to point to a user-supplied routine. 


Data Structures 


The system drivers use several data structures. The data structures for the STD-BIOS system drivers are 
contained in the STD-BIOS data area and use four data structures. The memory size and equipment 
determination drivers each use a word; the ROM software clock uses five bytes. These data structures are 
located at 040:13H, 040:10H, and 040:6CH respectively. The extended system support driver uses 9 bytes 
starting at location 040:98H. The EX-BIOS drivers are in the EX-BIOS data area and and use the global 
data area. These data structures are described in detail in Appendix B. 
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Equipment Determination Driver (INT 11H) 


Returns information about the equipment attached to the system. 





On Entry: No Inputs. 


On Exit: AX = Word with all equipment information: 


Bit Value Definition 
15, 14 Number of printers attached. 
13, 12 Not used. 
11, 10,.:9 Number of datacomm cards attached. 
8 Not used. 
7, 6 Number of diskettes attached: 
00 1 drive, 
01 2 drives, only if Bit 0 is also a 1 
5, 4 Initial video mode selected: 
00 Other. 
01 40x25 color adapter. 
10 80x25 color adapter. 
11 80x25 monochrome adapter. 
Sue Not used. 
1 Math coprocessor attached. 
0 01 Diskette drives attached. 


Registers Altered: AX. 





On Entry: No Inputs. 


On Exit: EAX = Double word with all equipment information. (# Indicates 
for Vectra RS only.) 


Bit Value Definition 
24 0 Weitek 1167* coprocessor not present 
24 1 Weitek 1167* coprocessor present 
23 0 Weitek 1167* coprocessor addressable 
by protected mode applications only 
23 1 Weitek 1167* coprocessor addressable 
by real and protected mode applications 
15, 14 Number of printers attached. 
13, 12 Not used. 
11, 10, 9 Number of datacomm cards attached. 
8 Not used. 
7, 6 Number of diskettes attached: 
00 1 drive, 
01 2 drives, only if Bit 0 is also a 1 
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5, 4 Initial video mode selected: 


00 Other. 

01 40x25 color adapter. 

10 80x25 color adapter. 

11 80x25 monochrome adapter. 
3-2 Not used. 
1 80387 math coprocessor attached. 
0 01 Diskette drives attached. 


Registers Altered: EAX. 


Memory Size Determination Driver (INT 12H) 

Returns the amount of RAM found in the system during the power-on and initialization routines. 
On Entry: No Inputs. 

On Exit: AX = Number of 1KB memory blocks found. 


Registers Altered: AX 


System Support Driver (INT 15H) 


The extended system support driver (INT 15H) provides functions which allow data to be transferred to 
and from extended memory and allow placing the CPU into its protected mode of operation. These 
functions are listed in Table 8-1. 


Table 8-1. System Support Driver Function Code Summary 


Function Function 
Value Equate 






















INT_SYSTEM System Functions Interrupt 
Unsupported 
F15_ DEVICE _OPEN Device Open 





Device Close 
Program Termination 
Event Wait 

Joystick Support 
System Request Key Pressed 

Wait Fixed Amount of Time 

Move Block of Memory to/from Extended Memory 
Get Extended Memory Size 


F15 DEVICE CLOSE 
F15_PROG_TERM 

F15 WAIT _EVENT 
F15 JOYSTICK 

F15 SYS REQ 

F15_ WAIT 

F15_ BLOCK_MOVE 
F1S_GET_XMEM 

_ SIZE 

F15_ENTER_ PROT 
F15_DEV_BUSY 
F15_INT_COMPLETE 
























Switch to Protected Mode 
Device Busy Hook 
Set Interrupt Completed Flag 
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System Support Driver Function Definitions 


F15 DEVICE OPEN (AH = 80H) 
Open device for I/O. This is a hook for multi-tasking systems. Currently the function just returns. 
On Entry: AH 


BX 
CX 


F1S DEVICE OPEN (80H) 
Device Identifier 
Process Identifier 


On Exit: No values returned. 


Registers Altered: None. 


F15 DEVICE CLOSE (AH = 81H) 
Close device for I/O. This is a hook for multi-tasking systems. Currently the function just returns. 
On Entry: AH 


BX 
CX 


F1S DEVICE CLOSE (81H) 
Device Identifier 
Process Identifier 


On Exit: No values returned. 


Registers Altered: None 


F15S PROG __ TERM (AH = 82H) 
Terminate Program. This is a hook for multi-tasking systems. Currently the function just returns. 
On Entry: AH 


BX 
CX 


F1S PROG TERM (82H ) 
Device Identifier. 
Process Identifier. 


On Exit: No register modified. 


Registers Altered: None 
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F15 WAIT_EVENT (AH = 83H) 


Allows a process to wait for at least "x" microseconds before it continues. The process is notified that the 
requested amount of time has elapsed when the high bit at ES:BX is set to "1". If another process is 
already using this function, the System Support Driver returns with the carry set. If the return status is 
successful (carry flag is clear), the process should poll the byte at ES:BX until the high bit is set. 


On Entry: AH = 
AL = 


ES: BX = 


CX,0X = 


On Exit: Carry 


F1S WAIT EVENT (83H) 
Subfunction: 

O = Set the timer with the data passed 

in ES, BX, CX and DX registers. 

1 = Cancel the current timer. 
The byte at this address will 
have its high bit set as soon as 
possible after the "x" 
microseconds. 
Minimum number, "x", of microseconds to 
wait before setting the high bit of the 
address above. CX is the most significant 
word. 


= 1 If there was another process already 
waiting. 
O If the calling process will be notified 
after the time out. 


Registers Altered: AX 


Fi5_ JOYSTICK (AH = 84H) 


Read data from the joystick port. 


On Entry: AH 
DX 


On Exit: Carry 


F1S JOYSTICK (84H) 
Subfunctions 

O = Read the switch settings. 
1 Read resistive inputs. 


Flag = O If no errors 
1 If invalid DX or no adapter present. 


If DX was 0, AL bits 7..4 contain switch positions. 


If DX was 1, AX 


X position of joystick 1 


BX = Y position of joystick 1 
CX = X position of joystick 2 
DX = Y position of joystick 2 


Registers Altered: AX, BX, CX, DX 


System Drivers 8-11 


Programming Example: To read all the data from the joystick adapter (switches and both joysticks). 


MOV AH, F15 JOYSTICK ; Function 84H 

MOV DX, 00 ; Read the switch settings first 

INT INT SYSTEM ; Int 15H 

JC HANDLE ERRORS 

MOV SWITCH STATE,AL 3; Save the state of the switches 
; Bits 7..4 in AL. 

MOV AH, F15 JOYSTICK ; Call it again for joystick info 

MOV DX, 01 

INT INT SYSTEM 

JC HANDLE ERRORS 

MOV STICK1 X, AX 3; Save x and y position for both 

MOV STICK! Y, BX 3; joysticks. 

MOV STICK2 X, CX 

MOV STICK2 Y, DX 


; Continues normally here 
HANDLE ERRORS: 


; Error handler here 


F15_SYS_REQ (AH = 85H) 


This subfunction gets called by the keyboard interrupt handler (INT 9H) whenever the user presses the 
<System request> key. Currently the routine just returns, but an application can trap this function to 
detect when the user presses this key. 


On Entry: AH 
AL 


F1S SYS REQ (85H) 
00, If user pressed the <System request> key down (make). 
01, If user let go of the <System request> key (break). 


On Exit: No values returned. 
Registers Altered: None. 


Example: Link into the current <System request> handler so that it prints "HELLO" everytime the 
<System request> key is pressed. 


INITIALIZATION CODE: 


MOV AH, 35H ; Get the old INT 15H 
MOV AL, INT SYSTEM ; Get CS:IP of INT 15H 
INT 21H ; This MS-DOS Int does the work 


MOV OLD SEG, ES 
MOV OLD OFFSET, BX 


MOV AH,25H 3; Replace old INT 15H 
MOV AL, INT SYSTEM 3; with our routine 
PUSH CS 

POP DS 
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MOV DX, offset OUR_INT15S 
INT 21H ; This MS-DOS Int does the work 


¢ 


OUR_INT15: 


CMP AH, F15_ SYS REQ ; See if it is function 85H? 
JNE DO OLD INT 

PUSHA 

PUSH ES 

MOV AX, F10_WRS 01 ; Yes, call video “write string” 
MOV BL, 07 ; function 1301H to write the 
MOV CX, 05 ; string "HELLO" 

MOV BH, 00 3 page 0 

MOV DX, 00 ; row 0, column 0 

PUSH CS 

POP ES 


MOV BP, Offset HELLO STR 
INT INT VIDEO 
POP ES 
POPA 
IRET 

DO OLD_INT: . 
PUSH OLD OFFSET 3 No, just go to regular routine. 
PUSH OLD_SEG 
RET 

HELLO_STR DB "HELLO" 


Video function interrupt 10H 


we 


F15__WAIT (AH = 86H) 


Calling this function causes a wait of the specified number of microseconds (CX, DX) before returning to 
the caller. 


On Entry: AH = F15 WAIT (86H) 
CX,DX = Number of microseconds to wait. 
CX is the most significant word. 


On Exit: Carry = 1, Some other process already 
waiting. So could not wait. 

0, Waited the amount of microseconds 
specified in the CX,DX register pair. 


Carry 


Registers Altered: None. 
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Example: Wait 10 milliseconds in a procedure. 


MOV AH, F15 WAIT ; 86H function 

MOV CX, 0 ; 10 * 1000 microseconds 
MOV DX, 10000 3; = 10 milliseconds 

INT INT SYSTEM ; INT 15H 


JC HANDLE_ERRORS 


; ; At least 10 milliseconds have elapsed 
HANDLE_ ERRORS: 
; Do what’s appropriate here. 


F15 BLOCK MOVE (AH = 87H) 

Moves a block of memory from one location to another anywhere in the addressing space of the CPU. 
The number of words to move is passed in CX and the source and destination tables pointers are passed in 
a Global Descriptor Table (GDT) pointed to by ES:SI. The following data structure describes a sample 
GDT: 


ADDRESS DATA STRUC 


RESERVED GDT OB 8 DUP (7?) ; Descriptor used during move 
CALLERS GOT DB~ 8 DUP (?) ; Caller’s GDTs during move 
SOURCE_GDT DB_~ 8 DUP (7?) 3; GDT describing source 
DEST_GOT DB 8 DUP (7?) ; GDT describing destination 
BIOS _GDT DB 8 DUP (?) ; GDT of the BIOS routines 
STACK GDT DB 8 DUP (?) ; Stack’s GDT. 


ADDRESS DATA ENDS 
The eight-byte descriptor for source or destination has the following format: 


SAMPLE GDT STRUC 


SEG_LIMIT DW Segment Limit 
LOW WORD DW Low word of 24-bit address 
HIGH BYTE DW High byte of 24-bit address 


ACCESS RIGHT DW 
RESERVED WORD DW 
SAMPLE_GDT — ENDS 


Segment access rights should always be 93H 
Reserved. 


Si i 
we we we we we 


On Entry: AH = F15 BLOCK MOVE (87H) 
ES:SI = Pointer to descriptor tables. 
CX = Number of words to move. 


On Exit: AH = Return Status: 
0, If successful. 
1, If RAM parity error. 
2, If exception interrupt error. 
3, If gate address line 20 failed. 


Carry Flag = 1, If failure. 
Zero Flag = 1, If successful. 


Registers Altered: AX 
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Example: Move the 16KB video buffer to the procedure’s buffer. 


MOV SI, offset DEST 
MOV 
AND 
SHR 
MOV 
SHL 
ADD 
INC 
INC 

SKIP_INC: 
MOV 
MOV 
LES 
MOV 
MOV 
INT 
JC 
JNE 


BX, 
BX, 
BX, 12 

AX, seg BUFFER 
AX, 4 

AX, offset BUFFER 
SKIP_INC 

BX 


seg BUFFER 
OF OOOH 


BYTE PTR HIGH BYTE[SI], BL 
WORD PTR LOW WORD[SI], AX 
SI, ACTUAL_TABLE 

CX, 8192 

AH, F15 MOVE BLOCK 
INT_SYSTEM 

HANDLE_ERRORS 

HANDLE ERRORS 


HANDLE ERRORS: 


ACTUAL TABLE: 


° 
9 


° 
9 
° 
b 


° 
9 


9 


Load table with 24 bit 
destination address: 
Isolate high nibble of segment 


isolate rest of segment 


; and form 24-bit address 


Number of words to move 
Function 87H. 
Int 15H 


Continue if 
everything OKAY 


Do Error processing here 
Actual Table of pointers 
passed to the routines. They 
use the Global descriptor 
structure described above. 


The high byte 
and low word will be 
loaded in the code 


RESERVED SAMPLE _GDT <0,0,0,0,0> 
CALLERS SAMPLE _GDT <0,0,0,0,0> 
SOURCE SAMPLE GDT <16384,8000H ,0BH,93H,0> 
DEST SAMPLE GODT <16384,0,0,93H,0> ; 
3 
> 
BIOS SAMPLE GDT <0,0,0,0,0> 
STACK SAMPLE _GDT <0,0,0,0,0> 
BUFFER DB 16384 DUP (7?) 


F15_ GET__XMEM_ SIZE (AH = 88H) 


9 


; Actual destination buffer 


Determine how much RAM there is above the first one megabyte of memory. 


On Entry: AH = F15 GET_XMEM SIZE (88H) 


On Exit: AX = Total number of 1KB blocks above one megabyte. 


Registers Altered: AX. 
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F15_ ENTER_ PROT (AH = 89H) 


Allows a routine to enter protected mode. When the BIOS function has executed, the processor will be in 
protected mode and the routine specified will be called. The calling program must create a set of 
descriptor tables as follows: 


Dummy Descriptor Table: Initialize to zero. 

Global Descriptor Table: Load program dependent values. 
Interrupt Descriptor Table: Load program dependent values. 
Data segment Descriptor: Load program dependent values. 
Extra segment Descriptor: . ‘Load program dependent values. 
Stack segment Descriptor: | Load program dependent values. 
Code segment Descriptor: . Load program dependent values. 
BIOS Descriptor Table: ‘Initialize to zero. 


When calling this function, the user should be aware that: 

1. The BIOS functions are not available. 

2. The interrupt tables must be moved to avoid conflict with the CPU interrupt vectors. 
3. The user loaded descriptor tables must not overlap with the BIOS’s descriptor tables. 


Upon return from protected mode the system BIOS will return control to the return point specified at 
40H:67H. The user should recover the stack and continue. 


There are a few points of caution that should be observed: 


1. Any code which is expected to run mixed mode, that is both protected mode and real mode, must 
not make any far references, including far calls. 


2. Also, any return addresses put on the stack must have been generated in the same mode in which 
the return code executes, or else they must be near returns. 


3. The system address line A20 must be forced to 0 when the system is operating in real mode. This 
task is performed by the 8042 controller. When the system enters protected mode, A20 must be 
released, and when it enters real mode it must be forced to 0 again. It is the program’s 
responsibility to issue the appropriate command to the 8042 controller before changing modes (see 
Chapter $5). ; 
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On Entry: AH F1S ENTER PROT (89H) 


BH = Offset into interrupt table where interrupts 
coming from the Master 8259 will go 
(Interrupt level 1). 
BL = Offset into interrupt table where interrupts 
coming from the slave 8259 will go (Interrupt level 2) 
ES:SI = Pointer to a set of descriptor tables. 


The following descriptors must be passed 
by the calling routine: 

Dummy Descriptor (DUMMY), 

Global Descriptor Table (GDT), 

Interrupt Descriptor Table (IDT), 

Data Segment Descriptor Table (DS), 
Extra Segment Descriptor Table (ES), 
Stack Segment Descriptor Table (SS), 
Code Segment Descriptor Table (CS) and 
BIOS Descriptor Table (BIOS). 


On Exit: AH = 0, If successfully entered Protected Mode. 


Registers Altered: All. 


Example: To enter protected mode and start executing the routine PROTECTED. 


; Load up descriptor tables with appropriate values. See the 
; iAPX 80286 or 80386 Programmer’s Reference Manual. for details. 
; 


; Load registers for calling INT 15H function. 


MOV AH, F15 ENTER PROT ; Enter protected mode function 89H 
; Offset for 8259’s must be greater than 32 
; because CPU uses the first 32 interrupts vectors. 

MOV BH, 40 ; New offset for master 8259. 

MOV BL, 48 3; New offset for slave 8259. 

MOV ES, seg GLOBAL TABLE ; Table of descriptors. 

MOV SI, offset GLOBAL_TABLE 

INT INT SYSTEM ; Int 15H 


PROTECTED: 


Code starts executing here after call to INT 15H 
sets up CS DT to point to PROTECTED label. 


Descriptor tables needed for this function 
call. The entries marked by ’F’ must be 
filled in by the user. Those marked with 
“0” are filled by INT 15H. For a definition 


we we we we we we wt we 
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we we we we 


3 
GLOBAL TABLE: 


RESERVED 
GLBL_DT 
IDT_DT 
DS_DT 

ES DT 
SS_DT 

cS _DT 
BIOS DT 


SAMPLE _GDT 
SAMPLE _GDT 
SAMPLE _GDT 
SAMPLE _GDT 
SAMPLE _GDT 
SAMPLE_GDT 
SAMPLE _GDT 
SAMPLE _GDT 


of the SAMPLE GDT structure see the 

F1S5 BLOCK MOVE example. For information as 
to how to fill this table see the iAPX 80286 
or 80386 Programmer’s Reference Manual. 


<0,0,0,0,0> 
<F,F,F,F,F> 
<F,F,F,F,F> 
<F,F,F,F,F> 
<F,F,F,F,F> 
<F,F,F,F,F> 
<F,F,F,F,F> 
<0,0,0,0,0> 


F15_ DEV__BUSY (AH = 90H) 


Device busy function. This is a “hook" for multi-tasking systems. Currently the function just clears the 
Carry flag and returns. 


On Entry: AH 
AL 


On Exit: 


No values 


Device 
0 thru 


F15 DEV BUSY (90H) 


Type: 
7FH = Device can not be shared. 


The operating system handling this "hook" 


mu 

80H th 
mu 

ha 

re 

OCOH t 
fo 

ti 

re 

List of Dev 
OOH 
01H 
02H 
80H 
OF DH 
OFEH 


Registers Altered: No 
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st serialize access to this device. 

ru OBFH = Device can be shared among 
ltiple processes. The operating system 
ndling this "hook" must use the ES:BX 
gisters to distinguish between calls. 

hru OFFH = Devices of this type must wait 
ra fixed amount of time. This amount of 
me is device dependant. Control should be 
turned to the device after the fixed amount time 
ice Types: 

Disc, timeout required 

Diskette, timeout required 

Keyboard, no timeout required 

Network, no timeout required 

Start diskette motor, timeout required 
Printer, timeout required. 


returned. 


ne. 





F15_ INT__COMPLETE (AH = 91H) 


Signals interrupt completed. This is a "hook" for multitasking systems. Currently the function does an 
IRET. 


F1S_ INT COMPLETE (91H) 
Device Type, see list of previous function. 


On Entry: AH 
AL 


On Exit: No registers used. 


Registers Altered: None. 


Time and Date Driver (INT 1AH) 
Table 8-2 describes functions provided by the BIOS to manage the CMOS clock and the software clock. 


Table 8-2. Time and Date Driver Function Code Summary 


Function Function . 
Value Equate 


INT_CLOCK Time and date 

FIA_RD CLK_CNT Read current clock count 

FIA _SET CLK CNT Set current clock count 
F1A_GET_RTC Read real-time clock 
F1A_SET_RTC Set real-time clock 
F1A_GET_DATE Read date from real-time clock 
FIA_SET DATE Set date in real-time clock 
F1A_SET_ ALARM Set alarm 
FIA_RESET ALARM Reset alarm 






















Time and Date Driver Function Definitions 


F1A_RD_CLK__CNT (AH = 00H) 

Reads the current setting of the software clock. There are 18.2 counts per second. 

On Entry: AH = F1A_RD CLK_CNT (00H) 

Zero if the timer has not overflowed (not passed 24 hours 
since the last read). Nonzero if time has overflowed. 


High word of the count. (There are 18.2 counts per second). 
Low word of count. 


On Exit: AL 


CX 
DX 


Registers Altered: AX, CX, DX 
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FIA_ SET_CLK__CNT (AH = 01H) 
Sets the count in the software clock. And resets the 24 hour overflow bit. 
On Entry: AH 


CX 
DX 


F1A_SET_CLK_CNT (01H) 
High word of Count. 
Low word of Count. 


On Exit: No values returned. 


Registers Altered: None 


F1A_ GET_RTC (AH = 02H) 
Gets the time from the real-time clock. 
On Entry: AH = F1A_GET_RTC (02H) 


On Exit: CH Hours in BCD. 
CL Minutes in BCD. 
DH Seconds in BCD. 


Carry flag = 1 if real-time clock is not operating. 


Registers Altered: AH, CX, DH 


FIA_ SET_RTC (AH = 03H) 
Sets the time of the real-time clock. 


On Entry: AH = F1A_SET_RTC (03H) 


CH = Hours in BCD. 

CL = Minutes in BCD. 

DH = Seconds in BCD. 

DL = 1 if daylight savings time 


option. 0 otherwise. 
On Exit: No values returned. 


Registers Altered: AH. 


FIA GET DATE (AH = 04H) 
Gets the date from the real-time clock. 


On Entry: AH = F1A_GET_DATE (04H) 
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On Exit: CH 19 if 20th century or 20 if 21st century. 


CL = Year in BCD. 
DH = Month in BCD. 
DL = Day in BCD. 


Carry flag set if the real-time clock not operating. 


Register Altered: AH, CX, DX. 


F1A__SET_ DATE (AH = 05H) 


Sets the date of the real-time clock. 


On Entry: AH = F1A_SET_DATE (05H) 
CH = 19 if 20th century or 20 if 21st century. 
CL = Year in BCD. 
DH = Month in BCD. 
DL = Day in BCD. 


On Exit: No values returned. 


Registers Altered: AH. 


F1A__SET__ALARM (AH = O6H) 


Sets the alarm to generate an INT 4AH when the specified amount of time has elapsed. The user must 
place an appropriate interrupt handling routine in the INT 4AH vector. 


On Entry: AH = F1A_SET_ ALARM (06H) 
CH = Hours in BCD. 
CL = Minutes in BCD. 
DH = Seconds in BCD. 


On Exit: Carry flag = 1 if the real-time clock is not operating 
or the alarm is already set. 


Registers Altered: AH. 


F1A_RESET_ ALARM (AH = 07H) 
Clears the current alarm if any was set. 

On Entry: AH = F1A_RESET_ALARM (07H) 
On Exit: No values returned. 


Registers Altered: AH. 
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V__SCOPY Driver (BP = 0000H) 


This driver does an IRET for all function calls. 


V__DOLITTLE Driver (BP = OOO6H) 


This driver does an IRET for all function calls. 


V__PNULL Driver (BP = O0OO0OCH) 


This driver loads AH with RS_- SUCCESSFUL and does an IRET for all function calls. 


V_SYSTEM Driver (BP = 0012H) 
Table 8-3 summarizes the V_ SYSTEM driver Functions. A more detailed description follows the table. 


Table 8-3. V_SYSTEM Driver Function Code Summary 


Function 
Equate 


V_SYSTEM 

F_ISR 

F_ SYSTEM 
F_SF_INIT 
F_INS_BASEHPVT 
F_INS_XCHGFIX 
F_INS_XCHGRSVD 


F_INS_XCHGFREE 
F_INS_FIXOWNDS 
F_INS_FIXGETDS 
F_INS_FIXGLBDS 
F_ INS FREEOWNDS 
F_INS_ FREEGETDS 
F_INS_FREEGLBDS 
F_INS_ FIND 
F_RAM_GET 


System Drivers 


System Management Functions 

Interrupt service routine (unsupported) 
Standard Driver Functions 

System initialization 

Returns HP_VECTOR_ TABLE segment 
Exchanges fixed table entries 

Sets next "reserved" entry in table 

Sets next “free” entry in table 

Install fixed vector, user supplies DS 

Install fixed vector, system supplies DS 

Install fixed vector, DS set to global data area 
Install next free vector, user supplies DS 
Install next free vector, system supplies DS 
Install next free vector, DS set to global data area 
Search for matching device header 

Get EX-BIOS memory pool address and size 





Table 8-3. V_ SYSTEM Driver Function Code Summary (Cont.) 


Function 
Equate . Definition 


F_ RAM_RET Set memory pool address and size 
F_CMOS_GET Read and verify CMOS memory 
F_CMOS_ RET Write to CMOS memory 
F YIELD Just returns 
Reserved 
Reserved 
F_SND_CLICK Enable keyclick 
_ ENABLE 
F_SND_CLICK Disable keyclick (Default) 
_ DISABLE 
F_SND_ CLICK Execute keyclick if enabled 
F_SND_ BEEP Enables beep 
__ENABLE 
F SND_BEEP Disables beep 
_ DISABLE 
F_SND_ BEEP Beeps if enabled 
F_ SND_SET _ BEEP Sets beep frequency 
F SND_TONE Produce tone, user supplied duration and frequency 
F_STR_GET Return next free string index 
_FREE_INDEX 
F_STR_DEL Delete bucket string list 
_ BUCKET 
F_ STR_PUT Add bucket to current string list 
_ BUCKET 
F_STR_GET _STRING | Search the list for index, return string 
F_STR_GET _ INDEX Search list for a string, return index 





Registers Altered: AH, DS, BP, ES 
Example: Get the Base address of the HP_VECTOR__TABLE. 


HP vector (12H). 

function 04H 

EX-BIOS destroys DS 

Int for EX-BIOS (default 6FH) 


MOV BP, V_SYSTEM 

MOV AH, F_INS BASEHPVT 
PUSH DS 

CALL SYSCALL 

MOV AX, DS 

POP DS ; Restore DS 
PUSH 

MOV GLOBAL _DATA_AREA, AX 

MOV AX, ES 

MOV VECTOR TABLE SEGMENT, AX 


we we we we 


The value returned in ES is the segment address of the HP_VECTOR_TABLE and the value returned in 
the DS register is the segment address of the EX-BIOS global data area. 
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V__SYSTEM Driver Function Definitions 


F ISR (AH = 00H) 
Logical interrupt service routine. Currently, it loads AH with RS_- UNSUPPORTED and does an IRET. 


On Entry: BP 
AH 


V_SYSTEM (12H) 
F_ISR (00H) 


On Exit: AH = RS UNSUPPORTED (02H) 


Registers Altered: AH, BP, DS 


F__SF__INIT (AX = 0200H) 


System functions routines. The only function supported is SF_INIT (00H). The rest of the routines 
return with a status of RS UNSUPPORTED in AH. 


The SF_INIT routine sets up DS and initializes all the variables in the EX-BIOS global data area. 
On Entry: BP 


AH 
AL 


V_SYSTEM (12H) 
F_SYSTEM (02H) 
SF_INIT (00H) 


On Exit: AH 
BX 


Return Status Code 
DS of EX-BIOS global data area 


Registers Altered: AH, BX, DS, BP 


F_ INS BASEHPVT (04H) 


Reports the segment where the HP_VECTOR_ TABLE is located. This function can only be called after | 
the V_SYSTEM driver has been initialized. 


On Entry: BP 
AH 


V_SYSTEM (12H) 
F_INS_BASEHPVT (04H) 


On Exit: AH 
ES 
DS 


Return Status Code 
Segment address of HP_VECTOR_TABLE. 
Segment of EX-BIOS global data area 
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FINS __XCHGFIX (AH = 06H) 


Exchanges the values in the registers for a particular entry in the HP_VECTOR_ TABLE. This function 
can be used to replace an existing vector at a fixed location without initialization. 


On Entry: BP 
AH 

BX 

DX 

ES:DI 


V_SYSTEM (12H) 

F_INS XCHGFIX (06H) 
Vector address 

DS to be exchanged 
CS:IP to be exchanged 


Return Status Code 
O = RS_SUCCESSFUL 
DS from table 
CS:IP from table 


On Exit: AH 


DX 
ES:DI 


Registers Altered: AH, BP, DS, ES, DI, Dx 
Example: Replace the EX-BIOS V_SVIDEO vector (54H). 
HP vector 12H. 


Function O6H 
HP vector 54H 


MOV BP, V_SYSTEM 
MOV AH, F_INS XCHGFIX 
MOV BX, V_SVIDEO 


wo wt we we we 


MOV DI, CS Get CS, IP and DS of new 

MOV ES, DI video routines. 

MOV DI, offset NEW VIDEO ROUTINE 

MOV DX, DS 

PUSH DS ; EX-BIOS Destroys DS 

CALL SYSCALL ; Int for EX-BIOS (default 6FH) 
POP DS 

MOV OLD CS, ES 3 Save old CS, IP and DS 

MOV OLD_IP, DI ; just in case we need to 

MOV OLD_DS, DX ; put them back 


F_INS__XCHGRSVD (AH = 08H) 


Exchanges the values in the registers for the next reserved entry in the HP_VECTOR_TABLE. If a 
reserved vector is not available, the function returns the RS_ NO VECTOR error code. 


On Entry: BP = V SYSTEM (12H) 


AH = F_INS_XCHGRSVD (08H) 
DX = DS to be exchanged 
ES:DI = CS:IP to be exchanged 
On Exit: AH = Return Status Code 
0 = RS_ SUCCESSFUL 
OF6H = RS_NO VECTOR 
BX = Vector address 
DX = DS from table 
ES:DI = CS:IP to be exchanged 


Registers Altered: AH, BP, DS, BX, ES, DI, DX 
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F INS _XCHGFREE (AH = OAH) 


Exchanges the values in the registers for the next free entry in the HP_VECTOR_ TABLE. If a free 
vector is not available, the function returns the RS_- NO_ VECTOR error code. 


On Entry: BP = V SYSTEM (12H) 


AH = F_INS XCHGFREE (OAH) 
DX = DS to be exchanged 
ES:DI = CS:IP to be exchanged 


On Exit: AH = Return Status Code 
6 = RS SUCCESSFUL 
OF6H = RS _NO_VECTOR 


BX = Vector address 
DX = DS from table 
ES:DI = CS:IP to be exchanged 


Registers Altered: AH, BP, DS, BX, ES, DI, DX 


F INS__FIXOWNDS (AH = OCH) 


Installs a given vector entry in the HP_VECTOR_ TABLE and calls it with an SF_INIT function. Upon 
returning from initialization, the routine returns its data segment in the BX register. 


(RP RE TIT EL NE I EN TT LEE Ee TT NL aT EE IE EERE, 


WARNING 


If the SF_INIT function returns with an error code of RS_ FAIL (OFEH), 
the power-on self test sequence will be executed. 





On Entry: BP = V_SYSTEM (12H) 


AH = F_INS FIXOWNDS (OCH) 
BX = Vector address to be installed 
ES:DI = CS:IP of the device 


On Exit: AH = Return Status Code 
Q = RS_SUCCESSFUL 


Registers Altered: AH, BP, DS 


F INS _FIXGETDS (AH = OEH) 


Installs a given vector entry in the HP_ VECTOR_TABLE and calls it with an SF_INIT function. This 
function should be used if the driver needs EX-BIOS RAM for its data segment. F_INS_ FIXGETDS calls 
the routine to initialize with the "last used DS" in the BX register. The routine’s initialization code 
decrements the "last used DS" value and returns to F_INS_FIXGETDS with this new value. 
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WARNING 


If the SF_ INIT function returns with an error code of RS_ FAIL (OFEH), 
the power-on self test sequence will be executed. 





On Entry: BP = V_SYSTEM (12H) 
AH = F_INS FIXGETDS (OEH) 
BX = Vector address to be installed 
ES:DI = CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS__FIXGLBDS (AH = 10H) 


Installs a given vector entry in the HP_VECTOR_ TABLE and calls it with an SF_ INIT function. When 
F_INS_FIXGLBDS calls the initialization routine it passes the data segment of the EX-BIOS global data 
area in the BX register. 





- WARNING 


If the SF_ INIT function returns with an error code of RS_ FAIL (OFEH), 
the power-on self test sequence will be executed. 





On Entry: BP = V_SYSTEM (12H) 
AH = F_INS FIXGLBDS (10H) 
BX = Vector address to be installed 
ES:DI = CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS_SUCCESSFUL 


Registers Altered: AH, BP, DS 
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F INS _FREEOWNDS (AH = 12H) 


Installs a vector in the next free entry of the HP_ VECTOR_ TABLE and calls it with an SF_INIT 
function. Upon returning from initialization, the routine returns its DS in the BX register. 





WARNING 


If the SF_INIT function returns with an error code of RS_ FAIL (OFEH), 
the power-on self test sequence will be executed. 





On Entry: BP = V_SYSTEM (12H) 


AH = F_INS FREEOWNDS (12H) 
BX = Vector address to be installed 
ES:DI = CS:IP of the device 


On Exit: AH = Return Status Code 
O = RS SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS_FREEGETDS (AH = 14H) 


Installs a vectcr in the next free entry of the HP_VECTOR_ TABLE and calls it with an SF_INIT 
function. This function is used if the driver needs EX-BIOS RAM for its data segment. 
F_INS_FREEGETDS calls the routine to initialize with the "last used DS" in the BX register. The 
routine’s initialization code decrements the "last used DS" value and returns it to F_INS_ FREEGETDS. 





WARNING 


If the SF_ INIT function returns with an error code of RS_ FAIL (OFEH) 
the power-on self test sequence will be executed. 





V_SYSTEM (12H) 
F_INS FREEGETDS (14H) 
CS:IP of the routine 


On Entry: BP 
AH 
ES:DI 


On Exit: AH = Return Status Code 
O = RS_SUCCESSFUL 


Registers Altered: AH, BP, DS 
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Example: Install the ACME_INT vector in the next free vector and allocate two paragraphs of data when 


its initialization routine gets called. 


MOV BP, V_SYSTEM 
MOV AH, F_INS_FREEGETDS 
MOV DI, CS 

MOV ES, DI 

MOV DI, offset ACME_INT 
PUSH DS 

CALL SYSCALL 

POP DS 

MOV VECTOR NUMBER, BX 


; HP vector 12H for EX-BIOS. 


> 


° 
+) 


; Function 14H 


Get CS, IP of ACME_INT routines 


EX-BIOS Destroys DS 
Int for EX-BIOS (default 6FH) 


Save the vector number 
routines are installed. 


; ACME_INT routine handles ifitialisat ion and 
: allocates 2 paragraphs roe EX-BIOS RAM for 


3; its data segment. 


ACME_INT: 
CMP AH, F_SYSTEM 
JNE NOT SUPPORTED 
CMP AL, SF_INIT 
JE ACME_INIT 
NOT SUPPORTED: 
MOV AH, RS UNSUPPORTED 
IRET 


ACME_INT: 
SUB BX, 2 


MOV DS, BX 


ASSUME DS:NOTHING 
MOV ACME ATTR, SSAAH 


MOV ACME _NAME_INDEX, SSAAH ; 


MOV AH, RS_SUCCESSFUL 


IRET 


we we we 


ACME SEG struc 

ACME _ATTR dw 0 

ACME NAME INDEX dw 0 
ACME REST db 28 dup (7) 
ACME SEG ends 


9 


we we we we 2 we we 


we 


? 


we we we wo 


Decode F_SYSTEM subfunction 
SF_INIT. 


Any unknown functions should 
return with RS_ UNSUPPORTED 
in AH. 


Decrement the “last used DS" passed 
to us. This allocates 2 paragraphs 
and makes our data segment the "last 
used DS". Make sure to pass this new 
BX back to F_INS FREEGETDS code. 

Now we can initialize the 

data in our segment. 


Put data into Attribute word 
Put a dummy index for now. 


Initialize rest 

of data segment here. 

Always return this status 

if successful initialization. 


Sample segment for this routine 


Attribute word of ACME’s data segment. 
Index name of ACME routine. 
rest of data segment 
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F INS _FREEGLBDS (AH = 16H) 


Installs a vector in the next free entry of the HP_VECTOR_ TABLE and calls it with an SF_INIT 
function. When F_INS_FREEGLBDS calls the initialization routine, it passes the data segment of the 
EX-BIOS global data area in the BX register. 





WARNING 


If the SF_INIT function returns with an error code of RS __FAIL (OFEH), 
the power-on self test sequence will be executed. 





On Entry: BP 
AH 
ES:DI 


V_SYSTEM (12H) 
F_INS FREEGLBDS (16H) 
CS:IP of the routine 


On Exit: AH = Return Status Code 
O = RS_SUCCESSFUL 


Registers Altered: AH, BP, DS 


F_INS_ FIND (AH = 18H) 


This function is used to search the HP_VECTOR_ TABLE for drivers that have equal or similar values in 
a specified field of their data segment. Parameters passed to the function specify the location of the 
16-bit field, the bits within the field to be compared (and_ mask) and the pattern of bits the field is to 
be compared with. Given a starting vector address, the function searches the vector table for the next 
driver that matches the conditions specified and returns its vector address in SI. 


On Entry: BP = V SYSTEM (12H) 


AH = F_INS FIND (18H) 
AL = 0 then respond on equality to pattern 
((field) .AND. (and _mask)) = pattern 
2 then respond on non_equal 
((field) .AND. (and_mask)) <> pattern 
BX = and_mask 
DX = pattern 
SI = vector address to start the search from. 
DI = field to be used in the function, this 


is the offset into an HP header. 


On Exit: AH = Return status 
0 = RS_ SUCCESSFUL 
OFEH = RS_FAIL--No match found 
SI = Vector address of the first entry that matched. 


Registers Altered: AH, BP, DS, SI 
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Example: Find a vector that has the value XSAXH ("X" means allow these digits to take any value) in its 
attribute header (the first word of the driver’s data segment) 


MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
PUSH 
CALL 
POP 
CMP 
JNE 


BP, V_SYSTEM 
AH, F_INS FIND 


HP vector 12H 
Function 18H 


AL, 0 ; Return RS SUCCESSFUL when the value is equal 
DI, 0 3; Look in the first word of driver’s data segment 
DX, OSAOH ; Look for value “°5A’ in the middle of the word. 
BX, OFFOH ; Mask off the don’t care parts. 

SI, 0 ; Start looking from the first vector position. 
DS ; EX-BIOS destroys DS 

SYSCALL ; Int for EX-BIOS (default 6FH) 

DS 


AH, RS_ SUCCESSFUL ; See if it found a match ? 


VECTOR NOT FOUND 
VECTOR FOUND: 
MOV SAVED VECTOR, SI 


; Yes 


VECTOR_NOT_ FOUND: ; No 


F_RAM_GET (AH = 1EH) 


This function gets the segment pointers of the EX-BIOS free RAM area. Two pointers are returned by ; 
this function call. The "last used DS" pointer marks the first paragraph of EX-BIOS RAM that is free for 
use. The "max DS" pointer marks the lowest value that “last used DS; can have. Figure 8-1 shows how 

the EX-BIOS memory is organized. 


See the F_RAM_RET memory function. 


On Entry: BP 


AH 


On Exit: AH 


BX 
DX 


V_SYSTEM (12H) 
F_RAM GET (1€H) 


RS_SUCCESSFUL 
“last used DS” 
“max DS" 


Registers Altered: AH, BP, DS, BX, DX 
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F__RAM_RET (AH = 20H) 


Sets the "last used DS" and "max DS" EX-BIOS pointers to the values passed in the BX and DX registers. 
This allows the calling routine to reserve a piece of the EX-BIOS memory. 





CAUTION 


The F_INS_FIXGETDS and F_INS_ FREEGETDS functions described 
above also modify these values. Use caution when allocating memory with 
both methods. | 





On Entry: BP = V SYSTEM (12H) 


AH = F_RAM GET (20H) 
BX = "last used DS" 
DX = "max DS" 


On Exit: AH = RS_ SUCCESSFUL 
Registers Altered: AH, BP, DS 
Example: The following code allocates five paragraphs (80 bytes) of EX-BIOS memory. 


; Check Get the memory pointers first. 
9 
MOV BP, V_SYSTEM ; HP vector 12H. 
MOV AH, F_RAM GET 3; function 1EH 
PUSH DS ; EX-BIOS Destroys DS 
CALL SYSCALL 3; Int for EX-BIOS (default 6FH) 
POP DS 


3; Check to see if there is enough memory to allocate 5 paragraphs. 


SUB BX, OO0O5H Create a new “last used DS" by 
moving pointer towards "max DS". 


Is “last used DS" >= “max DS"? 


oe we we 


CMP BX, DX 
JL NO_MEMORY LEFT 


ENOUGH _MEMORY_LEFT: 
MOV BP, V_ SYSTEM 
MOV AH, F_RAM RET 


Yes: Allocate 5S paragraphs. 
HP vector 12H 
function 20H 


we we we we we 


PUSH DS EX-BIOS Destroys DS 
CALL SYSCALL Int for EX-BIOS (default 6FH) 
POP DS 


MOV MEMORY SEG, BX ; Save this new memory pointer for later use 


Cont inue 


we 
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NO MEMORY LEFT: 3 No: 


Typical thing to do here is to allocate more 
memory for the the EX-BIOS RAM and reboot 
system. 


we we we we ww 


F CMOS_ GET (AH = 22H) 


Read a byte from CMOS. It verifies the checksum on the industry standard CMOS area and returns 
RS_ FAIL if the checksum 1s invalid. 


On Entry: BP = V SYSTEM (12H) 


AH = F_CMOS GET (22H) 
BL address of CMOS byte to read 
On Exit: AH Return Status Code 


AL byte of data from CMOS 


Registers Altered: AX, BP, DS. 


F_CMOS_ RET (AH = 24H) 


Write a byte to CMOS. Calculate a new checksum for both the industry standard CMOS area and the HP 
CMOS area. 


On Entry: BP = V_SYSTEM (12H) 
AH = F_CMOS_RET (24H) 
AL = byte of data to be written to CMOS 
BL = address of byte to be written to CMOS 


On Exit: AH = Return Status Code 


Registers Altered: AX, BP, DS. 
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Example: Make the monochrome display the primary video adapter by setting this information in the’ 
equipment byte of CMOS memory. 


e 
+ 


; Read the equipment byte. 


MOV BP, V_SYSTEM ; HP vector 12H. 


9 
MOV AH, F_CMOS GET ; function 22H 
MOV BL, 14H ; Address of the equipment byte 
PUSH DS ; EX-BIOS destroys DBS 
CALL SYSCALL ; Int for EX-BIOS (default 6FH) 
POP DS 


CMP AH, RS FAIL ; See if CMOS is valid 
JE INVALID _CMOS 


; Isolate the video and set appropiate video bits. 


AND AL, 110011118 
OR AL, 00110000B ; Select monochrome display 


; Write the equipment byte. 


MOV BP, V_SYSTEM ; HP vector 12H 
MOV AH, F_CMOS RET ; function 24H : 


PUSH DS 3; EX-BIOS destroys DS 
CALL SYSCALL ; Int for EX-BIOS (default 6FH) 
POP DS 


o 


INVALID CMOS: 


F__YIELD (AH = 2AH) 


Currently loads AH with RS SUCCESSFUL and does an IRET. This is a “hook" for multi-tasking 
systems. 


On Entry: BP 


V_SYSTEM (12H) 
F_YIELD (2AH) 


AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 
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F_SND_CLICK_ ENABLE (AH = 30H) 
Enables the keyclick function. 


V SYSTEM (12H) 


On Entry: BP = 
F_SND_CLICK_ENABLE (30H) 


AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS. 


F SND_CLICK DISABLE (AH = 32H) 
Disables the keyclick function, sets the EX-BIOS global data area T_SND_CLICK_DURA byte to zero. 


V SYSTEM (12H) 


On Entry: BP = 
F SND CLICK DISABLE (32H) 


AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F_SND_ CLICK (AH = 34H) 
This functions issues a keyclick. 


V_ SYSTEM (12H) 


On Entry: BP at 
F_SND_CLICK (34H) 
- 7 ( 


AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F SND _BEEP_ENABLE (AH = 36H) 
Enables the beep function. 


V SYSTEM (12H) 


On Entry: BP = 
F_SND_BEEP_ENABLE (36H) 


AH 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F__SND__BEEP__DISABLE (AH = 38H) 


Disables the beep function. 
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On Entry: BP 
AH 


V_SYSTEM (12H) 
F_SND BEEP_DISABLE (38H) 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F SND_BEEP (AH = 3AH) 


Makes a sound as defined by the current values of T_SND_ BEEP CYCLE and T_SND_BEEP_ DURA 
in the EX-BIOS data area. 


On Entry: BP 
AH 


V_SYSTEM (12H) 
F_SND BEEP (3AH) 


On Exit: AH = Return Status Code 


Registers Altered: AH, BP, DS 


F SND_SET_ BEEP (AH = 3CH) 


Defines beep frequency and duration. 


On Entry: BP = V_SYSTEM (12H) 
AH = F_SND SET BEEP (3CH) 
BX = Frequency 1 to 25000 hz. 
If (BX) = 0 then tone off. 
DX = duration of tone in 10 microsecond increments 


On Exit: AH = Return Status Code 

Registers Altered: AH, DS, BP. 

Example: Set beep frequency to 660 Hz for duration of 1/2 second. 
MOV BP, V_SYSTEM 
MOV AH, F_SND SET BEEP 


MOV BX, 660 
MOV DX, 50000 


HP vector 12H 

function 3CH 

Frequency in hertz 

1/2 a second in 10 microsecond 


we we we we we 


increments. 
PUSH AH, F_SND_SET_ BEEP 
PUSH DS ; EX-BIOS destroys DS 
CALL SYSCALL ; Int for EX-BIOS (default 6GFH) — 


POP DS 


F SND_ TONE (AH = 3EH) 


Generates a tone of the given frequency and duration with an approximate 0.5 percent error. 
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On Entry: BP = V_SYSTEM (12H) 
AH = F_SND TONE (3EH) 
BX = Frequency 1 to 25000hz. If (BX) = 0 then tone off. 
DX = Duration of tone in 10 microsecond increments. 


On Exit: AH = Return Status Code 


Registers Altered: AH, DS, BP 


F STR_GET_FREE_ INDEX (AH = 40H) 
Returns to caller the next string index that does not conflict with the ROM-based string indices. 


On Entry: BP 
AH 


V_SYSTEM (12H) 
F_STR_GET FREE_INDEX (40H) 


On Exit: AH 
BX 


RS_SUCCESSFUL 
Next free index. 


Registers Altered: AH, BX, DS, BP 
Example: This example gets the next string index available to the user. 


MOV BP, V_SYSTEM ; HP vector 12H 
MOV AH, F_STR_GET_FREE_INDEX 3; funct. 40H 
; 


PUSH DS EX-BIOS destroys DS 

PUSH BP, F_STR_GET_FREE_INDEX 

CALL SYSCALL ; Int for EX-BIOS (default 6FH) 
POP DS 

MOV FIRST FREE INDEX, BX ; Save it for later use. 


F STR_DEL_ BUCKET (AH = 42H) 
Finds a header with the given address and deletes it from the bucket header list. 


On Entry: BP = V SYSTEM (12H) 


AH = F_STR_DEL_BUCKET (42H) 
DI = offset address of bucket header 
ES = segment address of bucket header 


On Exit: AH : RS SUCCESSFUL if header found and deleted 
RS _ FAIL if header not found. 


Registers Altered: AH, DS, BP. 
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F_STR_PUT_ BUCKET (AH = 44H) 


Takes a header and its corresponding pointers and adds them to the front of the list. 


On Entry: BP = V_SYSTEM (12H) 
AH = F_STR_PUT_ BUCKET (44H) 
DI = Offset address of header 
ES = Segment address of header 


On Exit: AH = RS_ SUCCESSFUL 
Registers Altered: AH, BP, DS. 
Example: Adds a set of strings and its associated data structures for the ACME _INT driver. 


3; String data structures (see Figure 8-2) 
9 
. STR_ HEADER STRUC 

STR_NXT_HDR OD (7) 

STR_UPPER BOUND DW (2) 

STR LOWER BOUND DW (7) 

STR_LIST PTR DD (7) 

STR_SEGMENT DW (?) 

STR_HEADER ENDS 


Now build a bucket (set of strings) for the 
ACME_INT: 


we we we we we 


First list ACME_INT’s strings: 
size_acme_name db 1 acme_name - 


f_acme_name = $ 

acme_name db ‘Acme Co.’ ,OH 
]_acme_name = 

size_item_1 db 1_item_1 - f_item_1 - 1 
f_item 1 = §$ 

item 1 db ‘Hello World’ ,OH 
1_item_1 = $ 

size item 2 db 1_ item 2 - f_item2 - 1 
f_item 2 = $ 

item 2 db ‘Widgets’ ,OH 

1_item_2 = 


) 
; Now build table of bucket pointers: 
3 

acme _ptrs label near 

dw offset acme _name 

dw offset item 1 

dw offset item 2 
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6) 


r 
: Now build the bucket header 


acme_ bucket label near 


dw 
dw 
dw 
dw 
dw 
dw 
dw 


OFFFFH 

OFFFFH 

1002H 

1000H 

offset acme _ptrs 
segment acme ptrs 
segment acme_name 


data 


9 


structure 


This is the only bucket. 
Adding string indexes 1000 


address of pointer list 


; segment of all strings 


Do the function call to add bucket. 


MOV BP, V_SYSTEM 
MOV AH, F_STR_PUT_BUCKET 


b 


9 


& 


o 
> ] 


MOV DI, offset acme_bucket 
MOV ES, segment acme_bucket 
PUSH DS 

CALL SYSCALL 

POP DS 


: HP vector 12H 
: function 44H 


; EX-BIOS Destroys DS 


.. 1002 


Int for EX-BIOS (default 6FH) 


F STR_GET__ STRING (AH = 46H) 





Given an index, this function searches the list of bucket headers for the bucket pointer with the given 
index. It returns a pointer to the string. 


On Entry: BP 


On Exit: AH 


DS:SI 
ES:DI 


V_ SYSTEM (12H) 
AH 
BX 


String index 


CX 


F_STR_GET STRING (46H) 


RS SUCCESSFUL if index found in a bucket 
How many characters are in the string exclusive 


of the byte count and the zero byte at the end. 


Address of header where string was found. 
Pointer to first character of the string. 


Registers Altered: AH, CX, SI, DI, BP, DS, ES 
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Example: Search for the name of the ACME_INT routine as index 1000H. 


MOV BP, V_SYSTEM 

MOV AH, F_STR_GET STRING 
MOV BX, 1000H 

PUSH DS 

CALL SYSCALL 


HP vector 12H 

Function 46H 

Index of ACME_INT name string 
EX-BIOS destroys DS 

Int for EX-BIOS (default 6FH) 


we we we we we 


3 
; Write the string to the screen: 
3 


MOV AX, F10 WRS 00 Call the write string function. 


3 
MOV BP, SI_ ; Offset of string address 
PUSH DS ; 3; Segment of string address 
POP ES ; CX is already set 
MOV DX, 0 ; Cursor position at (0,0) 
MOV BH, 0 ; Video page 0 
MOV BL, 7 ; Character attribute 
INT INT VIDEO 3; Video interrupt 10 
POP DS ; Recover old DS 


F STR_GET_ INDEX (AH = 48H) 
Given a pointer to a string, it returns the index of the string if it is in the bucket header list. 
On Entry: BP 


AH 
ES:DI 


V_SYSTEM (12H) | 
F_STR_GET_INDEX (48H) 

Pointer to first character of 
the zero terminated string. 


On Exit: AH 
BX 


RS SUCCESSFUL if index was found. 
Index found for the given string. 


Registers Altered: AH, BX, BP, DS 
Example: Get the index of the ACME_NAME string. 
MOV BP, V_SYSTEM HP vector 12H 


) 
MOV AH, F_STR_GET_INDEX 3; function 48H 
MOV DI, seg ACME NAME ; Move segment of string 
’ 


MOV ES, DI into ES 

MOV DI, offset ACME NAME 

PUSH DS ; EX-BIOS destroys DS 

PUSH BP,OFFSET ACME _NAME 

CALL SYSCALL 3; Int for EX-BIOS (default 6FH) 
POP DS 


MOV ACME_NAME_ INDEX, BX 3; Save the index. 
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System Processes 





This chapter describes system processes contained in the ROM BIOS. System processes are different from 
drivers in that they are not readily accessible to application programs and they perform larger tasks than 
a typical driver function. The ROM BIOS has five main system processes: reset, power-on self test 
(POST), system generation (SYSGEN), booting (BOOT), and return from protected. mode. 


Reset 


The CPU is reset through a hardware reset signal. This signal sets the CS and IP registers to begin 
execution at memory location OF000:0FFFOH. The system can be reset by either a hardware reset to the 
CPU, or by any software routine that jumps to memory location OFOOO:0FFFOH. There are three events 
that initiate a system reset: 


= Power-on. - This reset occurs when power is applied to the system. The power supply resets the CPU 
through its reset signal when the system is turned on. POST is initiated and performs a full memory 
test. 


ws Soft Reset. - This reset is initiated by the <Ctrl>-<Alt>-<DEL> key sequence. This sequence is 
interpreted by the INT 09H keyboard interrupt service routine as a reset command. POST is 
initiated. A full memory test is not performed. 


= Programmatic Reset. - The final reset source is a software initiated hardware reset. A command is 
sent to the 8042 controller to pulse the CPU hardware reset line. Once the CPU has been placed in 
the Protected Mode, a hardware reset is the only method available to return to the Real Mode (the 
80386 can return to Real Mode by using a MOV CRO instruction). POST may or may not be 
performed depending upon the shutdown status byte in CMOS. 


Once a reset operation has been initiated by one of the three possible sources, the system must determine 
if it is a power-on reset. If it is a power-on reset, bit 2 in the 8042 controller’s status port is cleared. 
POST is performed. A command is sent to the 8042 to set bit 2. If it is not a power-on reset, bit 2 in the 
8042 controller status port is already set. The CMOS shutdown status byte determines whether POST is 
performed. 


If it is not a power-on reset, the system looks at the shutdown status byte (CMOS address OFH) to 
determine whether to perform POST or return from protected mode. If the shutdown status byte is set to 
one of the values that indicates the system is returning from protected mode, the reset process will 
initiate the return from protected mode process. This process is described next. All other values of the 
shutdown status byte are interpreted as reset commands, and the reset process will initiate the power-on 
self test process. The reset proces has completed its tasks when one of these two processes has been 
invoked. 
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Protected Mode Support 


The CPU has two modes of operation: Real mode and Protected mode. Real mode provides a 1 MB address 
space and is 8086 compatible. Protected mode provides memory protection, virtual memory addressing, 
and either a 16 MB (for the 80286 CPU), or a 4 gigabyte (for the 80386 CPU) physical address space. 
The normal mode of operation of the system is real mode. However, a few programs use protected mode, 
for example, VDISK.SYS, the MS-DOS virtual disc device driver. 


Additionally, the 80386 provides a third mode which is a subset of Protected mode: Virtual 8086 mode. 
In Virtual 8086 mode, an application would run as it would on an 8086 machine. This mode allows 
multi-tasking with older MS-DOS applications; each application allotted up to 1 MB of memory address 


space. 


The system provides some support to the programmer for use of the protected mode features. The INT 
15H driver provides two functions that support system operation in protected mode. One of these 
functions enables data to be moved to and from extended memory. This function enters protected mode to 
perform this task, and returns to real mode. The second function provides a method for programmers to 
switch into protected mode. These functions are described in Chapter 8 of this manual. 


Shutdown Status Byte 

The shutdown status byte is used by the system to determine what action should be taken on reset. Table 
9-1 shows how the shutdown status byte is interpreted. Note that any value that does not indicate a 
return from protected mode is interpreted by the system as a reset, and will cause the reset process to 


invoke POST. 


Table 9-1. Shutdown Status Byte 


Perform power-on reset sequence. 
Flush keyboard and jump via double word stored at 0040:0067H. 
Perform power-on reset sequence. 


Return from test of extended memory. 
Return from INT 15H block move function. 
Jump via double word stored at 0040:0067H. 
Perform power-on reset sequence. 





The values 08H and O9H are used internally by the ROM BIOS. If the return from protected mode 
process detects either of these values, it will branch to their respective routines. Values 05H and OAH 
should be used by all other programs returning from protected mode. 
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Power-On Self Test (POST) 


Each time the system is powered on, or a reset is performed, the POST process is executed. The purpose of 
the POST process is to verify the basic functionality of the system components and to initialize certain 
system parameters. The POST process performs the following tasks: 


Test the operation of the CPU. 

Test the system ROM. 

Test and initialize 8254 timer/counter and start the refresh counter. 

Test the first 64 KB of system RAM 

Test memory cache subsystem (Vectra RS/20C and RS/25° only.) 

Initialize the video display for diagnostic messages. 

Test and initialize DMA controllers and DMA page registers. 

Test and initialize the 8259A interrupt controllers. 

Test the 8042 controller and Scandoor. 

Test the HP-HIL controller. 

Test CMOS RAM for integrity. 

Determine if manufacturing electronic tool is present. If so, run manufacturing test. 
Test the remaining base system RAM (RAM above the first 64 KB). 

Test the extended RAM above memory address 100000H (protected mode RAM.) 
Test the real-time clock portion of the RTC/CMOS chip. 

Test the keyboard interface and the keyboard itself. 

Test. the flexible disc controller subsystem. 


Test the coprocessor if present (80287 for Vectra ES series, 80387 for Vectra QS series, and 80387 
and Weitek coprocessor for Vectra RS series). 


Test the CPU clock speed. 


Test serial port. 


The power-on self test performs tests on various subsystems in the hardware when power is switched on 
or when the system is reset. If a problem is detected, a 4 digit hex error code is displayed and four short. 
beeps are sounded. (In order for all codes to be displayed, the video display adapter must be a mv ltimode, 
a monochrome, or a color adaptor.) These codes are listed in Tables 9-2a (for Vectra ES series) and 9-2b 
(for Vectra QS and RS series). 
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Table 9-2a and 9-2b Legend: 


Error Code is in the form of 4 hex digits; X, Y, Z are hex digits. 
x = don’t care bit in the hex digit 

b = valid bit in the hex digit 

CGA = Clock Gate Array chip 

kbd = keyboard 

MFG = Manufacturing 





80* 26 U810 80286 CPU is bad 

ROM U28 Bad checksum on ROM O 

ROM U27 Bad checksum on ROM 1. 

RTC U108 One of the RTC (Real Time Clock) registers is bad. 
Reg # = X (0 - D). 

RTC RTC failed to tick. 

CMOS U108 CMOS/RTC has lost power. 

CMOS Invalid checksum on IBM CMOS area. 


CMOS Invalid checksum on HP CMOS area. 
CMOS One of the CMOS registers is bad 
Reg # = XY - 40 
Example: 024E = reg #E is bad 


8042 U1010 8042 failed to accept the RESET cmd. 
8042 8042 failed to respond to the reset cmd. 
8042 8042 failed on RESET. 
8042 8042 failed to accept the "WRITE CMD BYTE" cmd. 
8042 8042 failed to accept the data of the above cmd. 
Scandoor U128 8042 failed to accept scancode from port 68. 
Scandoor 8042 failed to respond to the above scancode. (This 
will happen when keyboard is locked up.) 
Scandoor 8042 responded incorrectly to the above scancode. 
Scandoor 8042 failed to accept cmd (command) from port 6A. 
Scandoor 8042 failed to generate SVC on port 67. 
Scandoor 8042 generate incorrect HPINT type on port 65. 
Scandoor 8042 failed the r/w register test on port 69. 
Scandoor 8042 failed to generate a HPINT on IRQ 15 
Scandoor 8042 failed to generate a HPINT on IRQ 12 
Scandoor 8042 failed to generate a HPINT on IRQ 11 
Scandoor 8042 failed to generate a HPINT on IRQ 10 
Scandoor 8042 failed to generate a HPINT on IRQ 7 
Scandoor 8042 failed to generate a HPINT on IRQ 5 
Scandoor 8042 failed to generate a HPINT on IRQ 4 
Scandoor 8042 failed to generate a HPINT on IRQ 3 
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Code Chip De- ription 








8042 failed to accept the kbd interface test cmd. 


Keyboard 
Keyboard 8042 failed to repsond to the kbd interface test cmd. 
Keyboard Kbd interface test failed: kbd clock line stuck low. 
Keyboard Kbd interface test failed: kbd clock line stuck high. 
Keyboard Kbd interface test failed: kbd data line stuck low. 
Keyboard Kbd interface test failed: kbd data line stuck high. 
Keyboard No acknowledgement from kbd self test cmd. 
Keyboard Bad acknowledgement from kbd self test cmd. 
Keyboard Kbd is dead or not connected. 
Keyboard No result from kbd self test cmd. 
Keyboard Kbd self test failed. 
Keyboard Kbd has stuck key: XX = scancode of stuck key. 
8042 8042 failed to enable Gate A20. 
Serial Serial Port dead or non-existent. 
Port 
Serial Serial Port fails register tests 
Port 
Parallel Parallel Port dead or non-existent. 
Port 
CGA Failed to switch to SLOW mode 
CGA Failed to switch to DYNAMIC mode 
CGA Timer (channel OQ) failed to interrupt 
CGA Memory cycles too slow in SLOW mode 
CGA Memory cycles too fast in SLOW mode 
CGA IO cycles too slow in SLOW mode 
CGA IO cycles too fast in SLOW mode 
CGA Memory cycles too slow in DYNAMIC mode 
CGA Memory cycles too fast in DYNAMIC mode 
CGA IO cycles too slow in DYNAMIC mode 
CGA 10 cycles too fast in DYNAMIC mode 
Timer One of the timer channels failed register test. 
X (O - 2) = timer channel that failed the test. 
Timer Memory Refresh signal stuck high. 
Timer Memory Refresh signal stuck low. 
DMA DMA #1 failed on register r/w (read/write) test. 
Reg # = X (0 - 7). 
| DMA DMA #2 failed on register r/w test. 
Reg # = X (0 - 7). 
DMA DMA page registers bad 


X (0 - 7) = bad register 
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HP-HIL 
Controller 


RAM 
Marching 
Ones 


RAM 
addr 
Indepen- 
dence 
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HP-HIL Controller chip failed the self test. 

X = xxxl => r/w fail with data = OdaSh 

X = xxlx => r/w fail with data = OdSah 

X = xIlxx => r/w fail with data = OaaSh 

X = 1xxx => r/w fail with data = OaSah 

Note: the above may be or’ed together to generate 
more complex error codes. 


HP-HIL device test failed. 


RAM in lower 640K failed the R/W test. 
X = bbbx => bbb (0-7) is # of 128K bank 

bbbO => indicate even byte bad 

bbb! => indicate odd byte bad 
YZ = bbbb bbbb => bits for which b=1 are bad. 
Follow the procedure below to identify the bad RAM 
chip(s) on the processor PCA. 


For X = 0, 2, 4, or 6, interpret YZ as follow: 
Y <> 0 => U23 is bad 
Z<>O => U13 is bad 


For X = 1, 3, 5, or 7, interpret YZ as follow: 
Y <> 0 => U43 is bad 
Z<>O => U33 is bad 


For X = 8, interpret YZ as follow: 
Y <> 0 => U22 1s bad 
Z<>OQO => U12 is bad 


For X = 9, interpret YZ as follow: 
Y <> 0O => U42 is bad 
Z<>0O => U32 is bad 


RAM in lower 640K failed the marching one test. 
X = bbbx => bbb (0-7) is # of 128K bank 

bbbO => indicate even byte bad 

bbb1 => indicate odd byte bad 

YZ = bbbb bbbb => bits for which b=1 are bad. 


Use the same procedure outlined for the 4X YZ error 
code to identify bad RAM chip(s) on the processor 
PCA for the marching ones test. 


Some address lines to RAM are stuck to 0 or 1. 

XY = 00bb bbbb => RAM address line bbbbbb is stuck. 
XY = Olbb bbbb => Multiple address lines are stuck. 
bbbbbb is the first bad one. 
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IO 
Channel 
Check 


Parity 
Ckt 


Master 
8259 
Mask 


Slave 
8259 
Mask 


Master 
8259 


Interrupt 


Slave 
8259 
Interrupt 


Flexible 
Disc 
Subsystem 


Description 


Parity error has occurred during RAM tests on the 
lower 640K of RAM. 
X = address in 64K bank where parity occurred. 


If X = 0 to 7, U21 or/and U31 is/are bad. 
If X = 8 to 9, U11 or/and U41 is/are bad. 


Parity error has occurred during RAM tests above the 
Ist MB (i.e., extended RAM on the I/O channel). 
XY = address in 64K bank where parity occurred. 


The parity generator circuit failed to generate parity 
error when unitialized RAM was read at power up. 


Master 8259 failed the r/w test on its mask register. 
XY = bbbb bbbb => bits in which b=1 is bad. 


Slave 8259 failed the r/w test on its mask register. 
XY = bbbb bbbb => bits in which b=1 is bad. 


Master 8259 failed the interrupt test. Note that this 
test uses the interval timer channel 0 to generate the 
interrupt. 


Slave 8259 failed the interrupt test. Note that this 
test uses the RTC to generate the interrupt. 


Error in Flexible Disc Controller (FDC) test. 


In POST, flexible disc error is one word, the primary 
report format. 

In Strife/ MFG, the error is two word, primary and 
secondary report: 


System Processes 





9-7 


Table 9-2a. } 


Primary 
Report 
Format: 
9XYZ X = flexible drive # (i.e. 0 = A:, 1 = B:) 
Y = 0 indicates Ist level error 
For Ist level error, 
Z = O = unsuccessful input from FDC 
1 = unsuccessful output to FDC 
2 = error while executing a seek 
error while executing a recalibrate 
4 = error while verifying ram buffer 
5 = error while resetting FDC 
6 = wrong drive identified 
7 = wrong media identified 
8 = no interrupt from FDC 
9 = failed to detect track 0 
A = failed to detect index pulse 





ow 
i) 


Y > O indicates higher level error 
1 = read sector error side 0 
2 = read sector error side 0 
3 = write sector error side I 
4 = write sector error side 0 
5 = format sector error side 0 
6 = format sector error side 1 
7 = read ID error side 0 
8 = read ID error side 1 

For higher level errors, 

Z = 1 = no ID address mark 
2 = no data address mark 

= media is write protected 

4 = sector number wrong 

5 = cylinder number wrong 

6 = bad cylinder 

7 = DMA overrun 

8 = ID CRC error 

9 = Data CRC error 

A = End of cylinder 

B = Unrecognizable error 


ww 


Secondary 

Report 

Format: 

9XYZ XY = xbbb bbbb where bbb bbbb 1s the cylinder 
number where failure occurred. 

Z = sector # where failure occurred. 
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Code 


A001 


A002 


AO00C 


CXYZ 


CFFF 


EXYZ 





Table 9-2a. Vectra ES POST Error Code Listing (Cont.) 


80287 U210 No 80287 is detected. This error code will not be 
reported in POST. 







80287 


80287 failed the R/W test on its stack registers. 


80287 80287 failed to generate an zero-divide interrupt. 







Extended 
RAM 


R/W test failure on extended RAM. 
X = 0 => even byte is bad. X = 1 => odd byte is 
bad. 

YZ = address in 64K bank where RAM failed. 









Since there could be many different type of RAM 
chips used in the extended memory, we will not 

provide the method here to identify the bad RAM 
chip(s) on the extended memory board. 












No extended RAM is found. This error code will not 
be reported in POST. 


Extended 
RAM 









Extended 
RAM 


Marching one test failure on extended RAM. 
X = 0 => even byte is bad. 
X = 1 => odd byte is bad. 
YZ = addr in 64K bank where RAM failed. 










Since there could be many different type of RAM 
chips used in the extended memory, we will not 

provide the method here to identify the bad RAM 
chip(s) on the extended memory board. 
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Test 






8042 
8042 
8042 
8042 
8042 
















Scandoor 
Scandoor 





Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 
Scandoor 


















Keyboard 
Keyboard 
Keyboard 
Keyboard 
Keyboard 
Keyboard 
Keyboard 
Keyboard 
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S POST Error Code Listing 


Description 


80386 CPU is bad. 
Bad checksum on ROM 0. 
Bad checksum on ROM 1. 


One of the RTC (Real Time Clock) registers is bad. 
Reg # = X (0 - D). 


RTC failed to tick. 


CMOS/RTC has lost power. 

Invalid checksum on IBM CMOS area. 
Invalid checksum on HP CMOS area. 
One of the CMOS registers is bad 

Reg # = XY - 40 

Example: 024E = reg #E is bad 


8042 failed to accept the RESET cmd. 

8042 failed to respond to the RESET cmd. 

8042 failed on RESET. 

8042 failed to accept the "WRITE CMD BYTE" cmd. 
8042 failed to accept the data of the above cmd. 


8042 failed to accept scancode from port 68. 

8042 failed to respond to the above scancode. (This will happen 
when keyboard is locked up.) 

8042 responded incorrectly to the above scancode. 
8042 failed to accept cmd (command) from port 6A. 
8042 failed to generate SVC on port 67. 

8042 generate incorrect HPINT type on port 65. 
8042 failed the r/w register test on port 69. 

8042 failed to generate a HPINT on IRQ 15 

8042 failed to generate a HPINT on IRQ 12 

8042 failed to generate a HPINT on IRQ 11 

8042 failed to generate a HPINT on IRQ 10 

8042 failed to generate a HPINT on IRQ 7 

8042 failed to generate a HPINT on IRQ 5 

8042 failed to generate a HPINT on IRQ 4 

8042 failed to generate a HPINT on IRQ 3 


8042 failed to accept the kbd interface test cmd. 
8042 failed to repsond to the kbd interface test cmd. 
Kbd interface test failed: kbd clock line stuck low. 
Kbd interface test failed: kbd clock line stuck high. 
Kbd interface test failed: kbd data line stuck low. 
Kbd interface test failed: kbd data line stuck high. 
No acknowledgement from kbd self test cmd. 

Bad acknowledgement from kbd self test cmd. 


Table 9-2b. \ 


Keyboard 
Keyboard 
Keyboard 
Keyboard 
8042 
Serial Port 


Serial Port 


Clock Speed 
Test for: 
82C301 
820301 
82C206 
820301 
820301 
82C301 
82C301 
82C301 
82C301 
82C301 


Timer 
Timer 
Timer 
DMA 
DMA 
DMA 


HP-HIL 
Controller 





; POST Error Code Listing (Cont.) 


Description 


Kbd is dead or not connected. 

No result from kbd self test cmd. 

Kbd self test failed. 

Kbd has stuck key: XX = scancode of stuck key. 
8042 failed to enable Gate A20. 

Serial Port dead or non-existent. 


Serial Port fails register tests. 


Failed to switch to SLOW speed 

Failed to switch to FAST speed 

Timer failed to interrupt 

CPU clock too slow in SLOW speed 

CPU clock too fast in SLOW speed 

CPU clock too slow in FAST speed 

CPU clock too fast in FAST speed 

Failed to switch to ATCLK for BUS clock 
CPU clock too slow at MEDIUM speed. 
CPU clock too fast at MEDIUM speed. 


One of the timer channels failed register test. 
X (O - 2) = timer channel that failed the test. 


Memory Refresh signal stuck high. 
Memory Refresh signal stuck low. 


DMA #1 failed on register r/w (read/write) test. 
Reg # = X (0 - 7). 

DMA #2 failed on register r/w test. 

Reg # = X (0 - 7). 

DMA page registers bad 

X (0 - 7) = bad register 


HP-HIL Controller chip failed the self test. 

X = xxxl => r/w fail with data = OdaSh 

X = xxlx => r/w fail with data = OdSah 

X = xilxx => r/w fail with data = OaaSh 

X = Ixxx => r/w fail with data = OaSah 

Note: the above may be or’ed together to generate more com- 
plex error codes. 
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HP-HIL 
Device 
RAM R/W 


RAM 
Marching Ones 


RAM addr 
Indepen- dence 


RAM Parity 


IO Channel 
Check 
Shadow RAM 
Shadow RAM 


Master 8259 
Mask 


Slave 8259 
Mask 
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(5 POST Error Code Listing (Cont.) 


Description 
HP-HIL device test failed. 


RAM in lower 640K failed the R/W test. 
X = bbcc => bb is # of 64K of 32-bit word bank 
cc = 00 => byte O is bad 
01 => byte 1 is bad 
10 => byte 2 is bad 
11 => byte 3 is bad 
YZ = bbbb bbbb => bits for which b=1 are bad. 


RAM in lower 640K failed the marching one test. 
X = bbcc => bb is # of 64K of 32-bit word bank 
cc = 00 => byte 0 is bad 

O01 => byte | is bad 

10 => byte 2 is bad 

11 => byte 3 is bad 
YZ = bbbb bbbb => bits for which b=1 are bad. 


Some address lines to RAM are stuck to 0 or 1. 

XY = OO0bb bbbb => RAM address line bbbbbb is stuck. 
XY = Olbb bbbb => Multiple address lines are stuck. 
bbbbbb is the first bad one. 


Parity error has occurred during RAM tests on the lower 640K 
of RAM. 
X = address in 64K bank where parity occurred. 


Parity error from memory installed in the I/O channel during 
the above RAM tests. 
XY = address in 64K bank where parity occurred. 


Shadow RAM is bad at BIOS segment. 
Shadow RAM is bad at HP EGA segment. 


Master 8259 failed the r/w test on its mask register. 
XY = bbbb bbbb => bits in which b=! is bad. 


Slave 8259 failed the r/w test on its mask register. 
XY = bbbb bbbb => bits in which b=1 is bad. 





Table 9-2b. 


7400 Master 8259 Master 8259 failed the interrupt test. Note that this test uses 
Interrupt the interval timer channel 0 to generate the interrupt. 


POST Error Code Listing (Cont.) 
























Slave 8259 
Interrupt 


Slave 8259 failed the interrupt test. Note that this test uses 
the RTC to generate the interrupt. 










Flexible Disc Error in Flexible Disc Controller (FDC) test. 


Subsystem 






In POST, flexible disc error is one word, the primary report 
format. 

In Strife /MFG, the error is two word, primary and secondary 
report: 
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Table 9-2b. ¥: ; POST Error Code Listing (Cont.) 


Description 


Primary 

Report 

Format: 

9XYZ X = flexible drive # (ie. 0 = A:, 1 = B:) 

Y = 0 indicates Ist level error 

For Ist level error, 

Z = O = unsuccessful input from FDC 
unsuccessful output to FDC 
error while executing a seek 
error while executing a recalibrate 
= error while verifying ram buffer 
= error while resetting FDC 
wrong drive identified 
wrong media identified 
no interrupt from FDC 
9 = failed to detect track 0 
A = failed to detect index pulse 


CONAN & WN — 
tl 


Y > 0 indicates higher level error 
1 = read sector error side 0 
2 = read sector error side 0 
3 = write sector error side 1 
4 = write sector error side 0 
5 = format sector error side 0 
6 = format sector error side 1 
7 = read ID error side 0 
8 = read ID error side 1 

For higher level errors, 

Z = 1 = no ID address mark 
2 = no data address mark 
3 = media is write protected 
4 = sector number wrong 
5 = cylinder number wrong 
6 = bad cylinder 
7 = DMA overrun 
8 = ID CRC error 
9 = Data CRC error 
A = End of cylinder 
B = Unrecognizable error 


Secondary 
Report 
Format: 
9XYZ XY = xbbb bbbb where bbb bbbb is the cylinder 
number where failure occurred. 
Z = sector # where failure occurred. 
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80387 No 80387 detected. POST will not report this error code. 
80387 80387 failed the R/W test on its stack registers. 

80387 80387 failed to generate an zero-divide interrupt. 

Weitek Weitek* coprocessor (COP) Test failed to enter Protected Mode. 
( * indicates for Vectra RS only.) 

Weitek* coprocessor not present (will not be reported in POST.) 













Weitek 








Weitek Weitek* coprocessor failed Registers Test. 
Weitek Weitek* coprocessor failed Addition Test. 
Weitek Weitek* coprocessor failed Multiplication Test. 
Weitek Weitek* coprocessor failed Interrupt Test. 






8042 ** Failed to switch to protected mode. (** indicates errors detec- 
ted by Memory Cache Test.) 


General cache subsystem failure. 






82385 






Read/write test of DRAM locations 60000h-6FFFFh failed. 
Decode bits in error code to isolate failing memory module: 
BXYZ where 
X = Olaa => aa specifies which byte is bad (0 -3 ) 
YZ = bbbb bbbb => b=1 specifies bad bit 
e.g.: 0100 0010 => bits 6 and 1 bad 
Read/write test of SRAM failed. 
Decode bits in error code to isolate failing chips: 
BXYZ where 
X = 10aa => aa specifies which byte is bad (0 - 3) 
YZ = bbbb bbbb => b=! specifies bad bit 
e.g.: 0100 0010 => bits 6 and 1 bad 
Marching ones test of SRAM failed. 
Decode bits in error code to isolate failing chips: 
BXYZ where 
X = |laa => aa specifies which byte is bad (0 - 3) 
YZ = bbbb bbbb => b=! specifies bad bit 
e.g.: 0100 0010 => bits 6 and 1 bad 
R/W test failure on extended RAM. 
X = 0 => even byte is bad. X = 1 => odd byte is bad. 
YZ = address in 64K bank where RAM failed. 
Since there could be many different types of RAM chips used in 
the extended memory, we will not provide the method here to 
identify the bad RAM chip(s) on the extended memory board. 
No extended RAM found. POST will not report this error code. 
Marching one test failure on extended RAM. 
X = O => byte 0 is bad. 
1 => byte 1 is bad. 
2 => byte 2 is bad. 
3 => byte 3 is bad. 
YZ = addr in 64K bank where RAM failed. 
Since there could be many different type of RAM chips used in 
the extended memory, we will not provide the method here to 
identify the bad RAM chip(s) on the extended memory board. 


Main Memory 
ae 






Static RAM 





Static RAM 





Extended RAM 










Extended RAM 
Extended RAM 
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If the POST process is initiated by a soft reset, the RAM tests and the cache memory test are not 
executed. This portion of POST determines the amount of system memory and performs a test of that 
memory. In all other aspects, POST executes the same for power-on, hard reset, and soft reset. 


SYSGEN then compares the configuration information stored in the CMOS memory with the actual 
system. If a discrepancy is found, a message will be displayed instructing the user to run the SETUP 
program. For example, if the CMOS memory indicates two flexible disc drives present, but the system 
contains only one, the message will be displayed. 


System Generation (SYSGEN) 


_ When the POST code module has completed its tasks, it initiates the system generation (SYSGEN) process. 
The SYSGEN process initializes the system software, then initiates the boot process. In general, the system 
data structures are initialized by the SYSGEN process, whereas the system hardware is initialized by the 
POST process. For example, the STD-BIOS and EX-BIOS data areas are initialized by the SYSGEN 
process. SYSGEN initializes the following items: 


| Interrupt vectors 

s § STD-BIOS data area 

a EX-BIOS data area 

The interrupt vectors are initialized to their default values. Processor interrupt vectors are initialized to 
their appropriate service routines. Hardware interrupt vectors are initialized to their service routines, or a 
null routine if they are unused. The interrupt vectors used to access the STD-BIOS drivers are initialized 
to their respective driver entry points. 

The STD-BIOS data area fields are initialized to their default values. Configuration dependent fields such 
as the base I/O address of the serial and parallel ports, current video mode, etc. are initialized at this 


time. 


The EX-BIOS data area is set up next in the SYSGEN process. Initializing the EX-BIOS data area 
consists of several distinct steps as outlined below. 
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Memory Allocation 


The first step in the process is to allocate system memory for the EX-BIOS data area. This memory 
allocation algorithm has two important features. First, by taking the memory size stored in CMOS 
memory into consideration, it allows large driver data areas to be allocated in the EX-BIOS data area. 
This method of expanding the EX-BIOS data area is explained in Chapter 8. Second, it prevents invalid 
CMOS memory size data from preventing the system from booting. If the CMOS memory size is set (using 
the SETUP program or writing directly to the CMOS memory) such that there is insufficient room for 
the EX-BIOS data area, this algorithm will adjust the value and write the new value to CMOS memory. 
The EX-BIOS data area is required to support the EX-BIOS extended features. 


There are three important variables in this calculation. 


@ RAM_SIZE--This is the top of actual system memory. It is usually 640 KB (system memory can be 
reconfigured as 256 or 512) and will always be an even multiple of 64 KB. 


m EX-BIOS_SIZE--This variable is the size of the EX-BIOS data area, which is 4 KB in its default 
configuration. 


@ . CMOS_SIZE--This is the memory size stored in CMOS. 


The CMOS _ SIZE is checked for validity. If it is between 4 KB and 64 KB from RAM _ SIZE, this value 
is used as the base of the EX-BIOS data area. If CMOS_SIZE is more than 64 KB from RAM_ SIZE, the 
base of the EX-BIOS data area is located 64 KB below the top of actual system memory. Finally, if 
CMOS_SIZE is less than 4 KB from the top of RAM_SIZE (or greater than the top of actual memory), 
the base of the EX-BIOS data area is located 4 KB from the top of system memory. The following 
formulas show this relationship: 


If (RAM_SIZE--CMOS_ SIZE) >n 4 KB and < 64 KB, 
then EX-BIOS_ SIZE = (RAM_SIZE--CMOS_ SIZE). 


If (RAM_SIZE--CMOS_ SIZE) >n 64 KB, 
then EX-BIOS_SIZE = 64 KB. 


If (RAM_SIZE--CMOS_ SIZE) < 4 KB, 
then EX-BIOS_ SIZE = 4 KB. 


The following examples illustrate this relationship: 


In a 640 KB system, if CMOS_SIZE is 512 KB, then the EX-BIOS_ SIZE data area starts at 576 KB. 
This leaves an 64 KB free area between the EX-BIOS_SIZE data area and the memory allocated to DOS. 


In a 640 KB system, if CMOS_ SIZE is 620 KB, then the EX-BIOS_ SIZE data area starts at 620 KB. In 


this case the EX-BIOS_ SIZE data area occupies all the area between the top of RAM and the memory 
allocated to DOS. 
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The HP  VECTOR_ TABLE Initialization 


Once the EX-BIOS data area has been allocated, and its base address determined, the 

HP _VECTOR_ TABLE is constructed. An image of the default HP _VECTOR_ TABLE is stored in the 
system ROM. This image is transferred from ROM to the base of the EX-BIOS data area. All free and 
reserved vectors are initialized to point at V_DOLITTLE, a null routine. Some of these vectors will be 
initialized to other drivers later in the SYSGEN process. 


EX-BIOS Driver Initialization 


The next step in the SYSGEN process is the initialization of the EX-BIOS drivers. Each driver is called 
with the SF_INIT subfunction. Some of the EX-BIOS drivers add vectors to the table when called to 
initialize. For example, the V_HPHIL driver initializes the vector addresses reserved for the HP-HIL 
physical device drivers. The HP_VECTOR_TABLE is fully initialized to its default state when each 
driver has been called in this manner. Additional drivers may be added or substituted by application 
programs or system software utilizing the vector maintenance functions of V_ SYSTEM (refer to Chapter 
8 for a description of these functions). 


Adapter and Option ROM Module Integration 


The ROM BIOS architecture allows code modules residing on adapter cards to be integrated into the 
system. These ROM modules must be in the system address range of OCOOO0OH - ODFFFFH. (Note that 
only video adapter cards can have base address in the range of OCOO00H through OC7FFFH). In addition 
to ROM modules located on adapter cards, the Processor PCA contains additional sockets for option 
ROMs. These option ROMs are addressed from OEOQO0H - OEFFFFH. ROM modules located on adapter 
cards or on the Processor PCA are integrated into the system in the same manner. 


All ROM modules contain a header and checksum byte. The header format is shown below: 


Byte 0--55H 

Byte 1--OAAH 

Byte 2--Length of ROM module in 512 byte blocks. 
Byte 3--Initialization entry point. 


Bytes O and 1 are signature bytes. All ROM modules must contain this signature at the start of the 
header in order to be identified by the SYSGEN process. 


Byte 2 of the header contains the number of 512 byte blocks in the ROM module, except the ROM 
module located on the Processor PCA (memory address OEOO00H). Byte 2 in that ROM module header is 
reserved. 


During the boot process, the address range from OCOOOOH to ODFFFFH is scanned in 2 KB blocks looking 
for valid option ROM headers. In addition, memory location OEOOOOH is also examined for a valid 
header. Since the scan does not proceed past OEOOOOH, only one ROM module can reside in the address 
range OEOQOOH to OEFFFFH. The Processor PCA will accept two different size ROMs, 32 KB or 64 KB. 
If a 32 KB part is installed, the ROM will appear in the system address space starting at location 
OE8000H instead of OEOOOOH. Therefore, the 32 KB ROM will not be integrated into the system by 
SYSGEN. 


If a valid ROM header is found, a checksum is computed for the ROM module. This is done by summing 


each byte in the ROM module. The sum of all the bytes in the ROM, including the checksum byte, must 
equal 0. For ROM modules located from OCO000H to ODFFFFH, the checksum is computed for the 
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number of bytes indicated in the length field of the header. For a ROM module located from OEQOOOH 
to OEFFFFH, this checksum is calculated on the entire 64 KB of address space. 


If the checksum is valid, a FAR call to byte 3 of the module is performed. The ROM module should 
perform any initialization required and then execute a RETF instruction. 


This integration process allows option ROMs to install vectors in either the HP_VECTOR_ TABLE or the 
low memory interrupt vectors. This re-vectoring process is the typical method used to integrate ROM 
modules into the system. 


Shadow RAM (HP Vectra QS and RS Series Only) 


On the HP Vectra QS and RS series, ROM integration is enhanced by a technique called Shadow RAM 
which speeds up system performance. Shadow RAM is a process where ROM is copied into high-speed 
32-bit RAM addressed at the same physical location. This provides faster access to ROM-based video 
subsystems (such as HP’s Enhanced Graphics Adapter) as well as HP Vectra QS and RS system BIOS 
firmware. This process is completed by the firmware during the power-up process and is completely 
transparent to applications. 


Boot Process (INT 19H) 


The boot process loads the operating system. The ROM BIOS INT 19H loads the boot sector from drive 
"A:" or "C:". This sector must contain the bootstrap loader for the operating system. Control is then 
passed to the code loaded from the boot sector. This code is responsible for loading the operating system. 
Refer to the appropriate operating system reference documentation for additional information on its boot 
process. 


Booting From a Flexible Disc 


The INT 19H driver attempts to read the boot sector from Drive “A:" (disc 0). It will retry the read four 
times before failing. The boot sector on flexible discs is located on Side 0, Track 0, Sector 1. Table 9-3 
contains a description of the contents of a valid boot sector. If drive "A:" contains a disc that does not 
have a valid boot sector, then the system will report the error message: 


Non-System disc or disc error 
Replace and strike any key when ready. 


If a valid boot sector is found, it is read into memory starting at location 07COH:0000H (07COOH) and 
control is transferred through a FAR JUMP to location 07COH:0000H. It is the responsibility of this code 
to load the rest of the operating system into memory. 


Booting From a Hard Disc 


If the flexible disc drive does not contain a disc, the system will attempt to boot from the hard disc. 
Booting from a hard disc is a two-step process. First, the active partition must be determined, then the 
boot record is read from the active partition. 


The hard disc can be divided into as many as four partitions. Each partition contains an operating system, 
programs, and data. Only one of the partitions can be active at any time. Partitions are added, deleted, 
activated, and deactivated using utilities provided with the respective operating systems. Partitions occupy 
a specified number of cylinders on the disc. For exaiaple, let’s say an optional 20 MB hard disc drive has 
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606 cylinders. One partition might occupy cylinders 0 through 303, while the second partition occupies 
cylinders 304 through 60S. If the active partition does not contain an operating system, the system will 
report the error message indicating such. 


Table 9-3. Boot Record 


ee 


Near JUMP instruction to boot code. 
OEM name and version number. 

Bytes per sector. 

Sectors per allocation unit. 

Reserved sectors. 

Number of File Allocation Tables (FATs). 
Number of root directory entries. 
Number of sectors in logical image. 
Media descriptor. 

Number of FAT sectors. 

Sectors per track. 

Number of heads. 

Number of hidden sectors. 

Boot code. 

55AAH signature word. 


















The first physical sector (cylinder 0, head 0, sector 1) of the hard disc contains the master boot record. 
The master boot record contains a code module and the disc partition table. The disc partition table 
contains the starting and ending cylinder of each of the disc partitions, as well as a flag that indicates 
whether the partition is active or not. Table 9-4 contains a description of the master boot record. 


Table 9-4. Hard Disc Master Boot Record 


a 


446 Bytes Master boot code. 
16 Bytes Partition table entry #1. 


16 Bytes Partition table entry #2. 
16 Bytes Partition table entry #3. 
16 Bytes Partition table entry #4. 
1 Word OAASSH signature word. 





A partition entry consists of 16 bytes. It contains information specifying the location of the partition, 
type of operating system, and a flag to indicate if the partition is active. Table 9-5 details the partition 
table entry. 
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number of bytes indicated in the length field of the header. For a ROM module located from OEOQOO0H 
to OEFFFFH, this checksum 1s calculated on the entire 64 KB of address space. . 


If the checksum 1s valid, a FAR call to byte 3 of the module is performed. The ROM module should 
perform any initialization required and then execute a RETF instruction. 


This integration process allows option ROMs to install vectors in either the HP _VECTOR_ TABLE or the 
low memory interrupt vectors. This re-vectoring process is the typical method used to integrate ROM 
modules into the system. 


Shadow RAM (HP Vectra RS Series Only) 


On the HP Vectra RS series, ROM integration is enhanced by a technique called Shadow RAM which 
speeds up system performance. Shadow RAM is a process where ROM 1s copied into high-speed 32-bit 
RAM addressed at the same physical location. This provides faster access to ROM-based video subsystems 
(such as HP’s Enhanced Graphics Adapter) as well as HP Vectra RS system BIOS firmware. This process 
is completed by the firmware during the power-up process and is completely transparent to applications. 


Boot Process (INT 19H) 


The boot process loads the operating system. The ROM BIOS INT 19H loads the boot sector from drive 
"A:" or "C:". This sector must contain the bootstrap loader for the operating system. Control is then 
passed to the code loaded from the boot sector. This code is responsible for loading the operating system. 
Refer to the appropriate operating system reference documentation for additional information on its boot 
process. 


Booting From a Flexible Disc 


The INT 19H driver attempts to read the boot sector from Drive "A:" (disc 0). It will retry the read four 
times before failing. The boot sector on flexible discs is located on Side 0, Track 0, Sector 1. Table 9-3 
contains a description of the contents of a valid boot sector. If drive "A:" contains a disc that does not 
have a valid boot sector, then the system will report the error message: 


Non-System disc or disc error 
Replace and strike any key when ready. 


If a valid boot sector is found, it is read into memory starting at location 07COH:0000H (07COOH) and 
control is transferred through a FAR JUMP to location 07COH:O000H. It 1s the responsibility of this code 
to load the rest of the operating system into memory. 


Booting From a Hard Disc 


If the flexible disc drive does not contain a disc, the system will attempt to boot from the hard disc. 
Booting from a hard disc is a two-step process. First, the active partition must be determined, then the 
boot record is read from the active partition. 


The hard disc can be divided into as many as four partitions. Each partition contains an operating system, 
programs, and data. Only one of the partitions can be active at any time. Partitions are added, deleted, 
activated, and deactivated using utilities provided with the respective operating systems. Partitions occupy 
a specified number of cylinders on the disc. For example, let’s say an optional 20 MB hard disc drive has 
606 cylinders. One partition might occupy cylinders 0 through 303, while the second partition occupies 
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cylinders 304 through 605. If the active partition does not contain an operating system, the system will 
report the error message indicating such. . 


Table 9-3. Boot Record 







































3 Bytes Near. JUMP instruction to boot code. 
8 Bytes OEM name and version number. 

1 Word | Bytes per sector. 

1 Byte Sectors per allocation unit. 

1 Word Reserved sectors. 

1 Byte Number of File Allocation Tables (FATs). 
1 Word Number of root directory entries. 

1 Word Number of sectors in logical image. 
1 Byte Media descriptor. 

1 Word Number of FAT sectors. 

1 Word Sectors per track. 

1 Word Number of heads. 

1 Word Number of hidden sectors. 

478 Bytes Boot code. 


1 Word 55AAH signature word. 


The first physical sector (cylinder 0, head 0, sector 1) of the hard disc contains the master boot record. 
The master boot record contains a code module and the disc partition table. The disc partition table 
contains the starting and ending cylinder of each of the disc partitions, as well as a flag that indicates 
whether the partition is active or not. Table 9-4 contains a description of the master boot record. 


Table 9-4. Hard Disc Master Boot Record 























446 Bytes Master boot code. 

16 Bytes Partition table entry #1. 
16 Bytes Partition table entry #2. 
16 Bytes Partition table entry #3. 
16 Bytes Partition table entry #4. 





1 Word OAAS5H signature word. 


A partition entry consists of 16 bytes. It contains information specifying the location of the partition, 
type of operating system, and a flag to indicate if the partition is active. Table 9-5 details the partition 
table entry. . 
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Table 9-5. Partition Table Entry Record 


Boot indicator. 



















Byte 


1 

1 Byte Starting head number. 

1 Byte Starting sector number. 

1 Byte Starting cylinder number.* 
1 Byte System indicator.* * 

1 Byte Ending head number. 

1 Byte Ending sector number. 

1 Byte Ending cylinder number.* 


Number of sectors in preceding partitions. 
Total number of sectors in partition. 


* The actual cylinder number is a ten-bit value composed of the cylinder byte plus the 
two most significant bits of the associated sector byte. These two bits are the most sig- 
nificant bits of the ten-bit number. 


&t System indicators are: 
OOH = Unknown operating system 
01H = DOS (12-bit FAT) 
04H = DOS (16-bit FAT) 


The INT 19H code will load the code module contained in the master boot record into memory, then 
transfer control to it. This code scans the data in the disc partition table to determine the active partition 
and its starting cylinder. The first sector of the active partition becomes the logical boot sector of the 
partition, and it contains a boot record. The boot record has the same format as the boot record contained 
on a flexible disc, except that some of the parameters are adjusted for the increased capacity of the hard 
disc partition. Refer to Table 9-3 for the format of a typical boot record. 
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BIOS Interrupts 





This appendix includes three tables. The first lists the interrupt vector assignments. The second lists each 
of the STD-BIOS interrupts with supported functions. The third lists the EX~BIOS drivers, their vector 


addresses, functions and subfunctions. 


> Ww 


Oo CO ~ IAN 


A 
B 


000-003H 
004-007H 
008-00BH 


00C-00FH 
010-013H 


014-017H 
018-01BH 


— 01C-01FH 


020-023H 
024-027H 


028-02BH 
02C-02FH 


030-033H 
034-037H 
038-03BH 
03C-03FH 
040-043H 
044-047H 
048-04BH 
04C-04FH 
050-053H 


054-057H 
058-05BH 


Divide by Zero 
Single Step 
Nonmaskable 
Interrupt 
Breakpoint 
Arithmetic 
Overflow 
Print Screen 
Invalid Opcode 
Reserved 
Timer Interrupt 
Keyboard ISR 
(IRQ 1) 
Reserved (IRQ 2) 
Serial Port 1 
ISR (IRQ 3) 
Serial Port 0 
ISR (IRQ 4) 
Printer Port 1 
ISR (IRQ 5) 
Flexible Disc 
- ISR (IRQ 6) 
Printer Port 0 
ISR (IRQ 7) 
Video 
Equipment Check 
Memory Size 
Flexible Disc/ 
Hard Disc 
Serial 
System Functions 
Keyboard 


Table A-1. Interrupt Vector Assignments 


Type/ 
Routine * 


STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 





BIOS Interrupts 


A-1 


A-2 


Table A~-1. Interrupt Vector Assignments (Cont.) 


Address Type / 
Routine * 


05C-05FH 
060-063H 
064-067H 
068-06BH 
06C-06FH 
070-073H 
074-077H 
078-07BH 
07C-07FH 
080-083H 
084-087H 
088-08BH 
08C-08FH 


090-093H 
094-097H 


098-09BH 
09C-09FH 


0A0-0CBH 
OCC-0CFH 


ODO-OFFH 
100-103H 


104-107H 


108-117H 
118-11BH 


11C-17FH 
180-19FH 


1A0-1BBH 
1BC-1BFH 


1CO-1C3H 


BIOS interrupts 


Printer 

Reserved 

Boot 

Time and Date 

Keyboard Break 

Timer Tick 

Video Parameter 
Table 

Flexible Disc 
Parameter Table 

Graphics Character 
Table 

Program Terminate 

DOS Function Calls 

DOS Terminate 
Address 

DOS <Ctrl>- 
<Break> Address 

DOS Critical Error 

DOS Absolute Disc 
Read 

DOS Absolute Disc 
Write 

DOS Terminate 
Stay Resident 

Reserved for DOS 

Mouse (RAM 
driver) 

Reserved for DOS 

Alternate Flexible 
Disc 

Hard Disc 
Parameter Table 

(0) 

Reserved 

Hard Disc 
Parameter Table 

(1) 

Reserved 

Reserved for User 

Programs 
Programs 

Unused 

Default EX-BIOS 
Entry Point 

Real-time Clock 
ISR (IRQ 8) 


Service 


STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 
STD-BIOS 


STD-BIOS 
STD-BIOS 
DOS 
DOS 
DOS 


DOS 


DOS 
N/A 


DOS 
STD-BIOS 


STD-BIOS 


STD-BIOS 
STD-BIOS 


STD-BIOS 
N/A 


N/A 
EX-BIOS 


STD-BIOS 
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1C4- IC7H. SW Redirected STD-BIOS 
(IRQ 9) 

1C8-1CBH Reserved (IRQ 10) STD-BIOS 

1CC-1CFH Reserved (IRQ 11) STD-BIOS 

1D0-1D3H HP-HIL (default EX-BIOS 
IRQ 12) 

1D4-1D7H Coprocessor STD-BIOS 
(IRQ 13) 

1D8&-1DBH Hard Disc ISR STD-BIOS 
(IRQ 14) 

1DC- 1DFH Reserved (IRQ 15) STD-BIOS 

1E0-1FFH Not Used N/A 

200-3C3H Reserved N/A 

3C4-3FFH Not Used N/A 





* PI--Processor interrupt 
HW--Hardware interrupt 
SW--Software interrupt 
PT--Interrupt vector used as pointer to data 
N/A--Not applicable 


(1) UI--Unused interrupt ISR 
(2) DRVR--Application callable entry point 
(3) IRET--Interrupt return 


The Table A-2 lists the STD-BIOS interrupt vectors, their usage and, where appropriate, their functions. 
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Table A~2. STD-BIOS Interrupts and Functions 


Function Function 
Value Equate ‘Definition 


Divide by zero 
Single step 
Non-maskable interrupt 
Breakpoint 
Arithmetic overflow 
Print screen 
Invalid opcode 
Reserved 
Timer interrupt 
Keyboard ISR 
Reserved 
Serial port 1 ISR 
Serial port 0 ISR 
Printer port | ISR 
Flexible Disc ISR 
Printer port 0 ISR 
INT_ VIDEO Video 
F10 SET MODE Set video mode 
01H F10_SET_CURSIZE Set cursor size 
02H F10_SET_CURPOS Set cursor position 
03H F10 RD CURPOS Read cursor position 
04H Fi0_ RD PENPOS Read light pen position 
OSH F10_ SET PAGE Set active display page 
06H Fi0_SCROLL_UP Scroll rectangle up 
07H F10_SCROLL_DN Scroll rectangle down 
08H F10_ RD -CHARATR Read character and attribute at 
cursor position 
09H F10_WR_CHARATR Write character and attribute at 
cursor position 
OAH F10_WR_CHARCUR Write character at cursor 
position 
OBH F10_SET_ PALLET Set color pallet 
OCH F110 WR_ PIXEL Write pixel 
ODH FIO RD _ PIXEL Read pixel 
OEH F10_ WR _CHARTEL Write teletype character 
OFH Fi0_GET_STMODE Get video state and mode 
10H-12H Reserved 
Write string functions 
1300H F10_ WRS_ 00 global attribute 
1301H F10_ WRS Ol global attribute, move cursor 
1302H F10 WRS_ 02 individual attributes 
1303H F10 WRS_ 03 individual attributes, move 
cursor 
6FOOH F110 INQUIRE EX-BIOS present 
6F01H F10_GET_INFO Get video parameters 
6F02H F10 SET INFO Set video parameters 
6F03H Fi0_ MOD_INFO Modifies video parameters 
6F04H F10_GET_RES Report video resolution 
6FOSH F10_XSET_ MODE Set video resolution 
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INT Function Function 
Hex Value Equate 


11H 
12H 


13H 


14H 


15H 


Table A-2. STD-BIOS Interrupts and Functions (Cont.) 








INT_EQUIPMENT 
INT_MEM_ SIZE 




















INT_ DISC 

F13_ RESET DISC 

F13_ RD _LSTATUS 
F13_ RD SECTORS 
F13_WR_ SECTORS 
F13_ VR_ SECTORS 
F13_ FORMAT_ FLEX 























F13_ FORMAT_HDISC 
F13_GET_HPARMS 



























F13_ TRACK SEEK 
F13_ ALT RESET 











F13_GET_DASD 
F13_CHG_ STATUS 
F13_ SET_DASD 
INT_ SERIAL 
F14_INIT 

F14._ XMIT 

F14_ RECV 

F14_ STATUS 

F14_ INQUIRE 
F14_EXINIT 































Fi4_PUT_BUFFER 
F14_ GET BUFFER 
F14_TRM_ BUFFER 














INT_ SYSTEM 































F15_DEVICE_OPEN 
F15_ DEVICE CLOSE 
F15_ PROG _TERM 

F15 WAIT _ EVENT 
F15_ JOYSTICK 

FI5 SYS REQ 

F15_ WAIT 

F15 BLOCK _MOVE 

























Definition 


Equipment check 
Memory size 
-- Note: both hard and flexible 
discs share interrupt 13H -- 
Disc Functions 

Reset Disc 

Read status of last operation 
Read sectors 

Write sectors 

Verify sectors 

Format flexible disc track 
Reserved 

Format hard disc 

Get hard disc parameters 
Reserved 

Seek to track 

Alternate hard disc reset 
Reserved 

Read disc type (DASD) 

Get disc change line status 

Set disc type for formatting 
Serial 

Initialize serial port parameters 
Send out one character 
Receive one character 

Get serial port status 

EX-BIOS present 

Initialize serial port (19.2 
Kbaud) 

Write a buffer of data 

Read a buffer of data 

Read a buffer of data, terminate 
on specified condition 

System functions 

Unsupported (turn on cassette 
motor) 

Unsupported (turn off cassette 
motor) 

Unsupported (read data blocks) 
Unsupported (write data blocks) 
Device open 

Device close 


| Program termination 


Event wait 

Joystick support 
System request key pressed 
Wait fixed amount of time 
Extended memory transfer 
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Table A-2. STD-BIOS Interrupts and Functions (Cont.) 


Function 
Equate 


Function 
Value 


INT 
Hex 





























88H 
89H 
90H 
8BH 


F15_GET_XMEM _ SIZE 
F15 ENTER PROT 
F15_DEV_ BUSY 
F15_INT_COMPLETE 



















INT_KBD 
00H F16_GET_KEY 
01H F16 STATUS 
02H F16 KEY STATE 
03H F16_SET_TYPE_RATE 
05H Fi6_ PUT _KEY 
10H F16_GET_EXT 


















11H 
12H 


F16_EXT_ STATUS 
F16_EXT_ KEY STATE 

















6FOOH 









F16_ INQUIRE 


6FO1H F16 DEF _ATTR 
6F02H F16_GET_ATTR 
6F03H F16_ SET _ATTR 


6F04H F16_DEF MAPPING 










































6F0SH F16_GET_MAPPING 


6F06H F16_SET_MAPPING 
6FO7H F16 SET XLATORS 
6FO8H F16_ KBD 

6FO9H F16 KBD_ RESET 
6FOAH F16_ READ SPEED 
6FOBH F16_SET_LOW_ SPEED 
6FOCH F16_ SET HIGH SPEED 


6FODH F16_GET_INT_NUMBER 
























INT_PRINTER 






































00H F17_PUT_CHAR 

01H F17_ INIT 

02H F17_ STATUS 

6FOOH F17_ INQUIRE 

6FO1H 

6F02H F17_PUT_BUFFER 

6F03H 

6F04H 

6FOFH F16_ SET CACHE ON 
6F10H F16_SET CACHE OFF 
6F11H ~~ | F16_GET_CACHE_ STATE 
6F12H F16_SET_MEDIUM_ SPEED 












INT_ BOOT 
INT_ CLOCK 
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Get extended memory size 
Switch to protected mode 
Device busy hook 
Set Interrupt Completed Flag 
Keyboard 
Read keycode from kybd buffer 
Report status of keyboard buffer 
Get key modifier status 
Set typematic rates 
Put data into keyboard buffer 
Read keycode from buffer (in- 
cluding extended keycodes) 
Report extended keyboard status 
Get Extended Key Modifier 
status 
EX-BIOS present 
Report default typematic values 
Report typematic values 
Set typematic values 
Report default translator 
assignments 
Report translator assignments 
Set translator assignments 
Set CCP and HP Function keys 
Report keyboard information 
Reset keyboard to defaults 
Read current speed 
Select machine’s slowest speed 
Select machine’s fastest speed 
Return the current HPENTRY 
vector 
Printer 
Send printer one byte 
Initialize printer port 
Get printer port status 
EX-BIOS present 
Reserved 
Write a buffer to printer port 
Reserved 
Reserved 
Turn cache on 
Turn cache off 
Get current cache state 
Sets medium speed for cache 
machines 
Reserved 
Boot 

Time and date 





Table A-2. STD-BIOS Interrupts and Functions (Cont.) 


INT Function Function . | on : 
Hex Value Equate Definition 





































































































































F1A_GET_DATE Read date from real-time clock 
FIA SET DATE Set date in real-time clock 
FIA SET ALARM Set alarm 
F1A_ RESET ALARM Reset alarm 
1BH Keyboard break 
1CH Timer tick 
1DH Video parameter table 
1EH Flexible disc parameter table 
1FH Graphics character table 
20H Program terminate 
21H DOS function calls 
22H DOS terminate address 
23H DOS <Ctrl>-<Break>n address 
24H _ DOS critical error 
25H DOS absolute disc read 
26H DOS absolute disc write 
27H DOS terminate stay resident 
28H-32H Reserved for DOS 
33H INT_HPMOUSE Reserved for Mouse driver 
34H-3FH Reserved for DOS 
40H Alternate flexible disc 
41H Hard disc parameter table (0) 
42H-45H Reserved 
46H Hard disc parameter table (1) 
47H-SFH Reserved 
60H-67H Reserved for user programs 
68H Reserved 
69H Reserved 
6AH Reserved 
6BH Reserved 
6CH Reserved 
6DH Reserved 
6EH Reserved 
6FH HP_ENTRY (default) Default EX-BIOS entry point 
70H Real-time Clock ISR (IRQ 8) 
71H SW redirected (IRQ 9) 
72H Reserved (IRQ 10) 
73H Reserved (IRQ 11) 
74H Reserved (IRQ 12) 
75H Coprocessor (IRQ 13) 
76H Hard disc ISR (IRQ 14) 
77H Reserved (IRQ 15) 
78H- 7FH Not used 
-80H-FOH Reserved 


F1H-FFH Not used 
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. EX-BIOS Drivers and Functions 


Many additional features of the HP system can be accessed through the software interrupt INT 6FH 
(EX-BIOS extensions, see Table A-3). To call the EX-BIOS extensions, the BP register must contain the 
vector address of the desired driver, the AH register must contain the function code, and the AL register 
must contain the subfunction code. The rest of the registers are available for passing data and returning 
data to and from the routine. 


In general, the AX, BP and DS registers are not preserved. They must be preserved by the calling routine 


if it needs them. See Chapter 2 for an example showing how EX-BIOS drivers are called. 


Table A-3. EX-BIOS Drivers and Functions 


Vector Func. | Function 
Address Value Equate 







































































0000H V_SCOPY Copyright notice routine 

0006H V_DOLITTLE NOP routine (IRET) 

000CH V_PNULL Null device driver 

0012H V_ SYSTEM System management functions 

0012H F_ISR Interrupt service routine 
(unsupported) 

0012H F_SYSTEM Standard driver functions 

0012H SF_INIT System initialization 

0012H F_INS _ BASEHPVT Return HP_VECTOR_ TABLE 
segment 

0012H F_INS _XCHGFIX Exchange fixed table entries 

0012H F_INS _XCHGRSVD Set next "reserved" entry in 
table 

0012H F_INS _XCHGFREE Set next "free" entry in table 

0012H F_INS _FIXOWNDS Install fixed vector, user supplied 
DS 

0012H F_INS _FIXGETDS Install fixed vector, system sup- 
plies DS 

0012H F_INS _ FIXGLBDS Install fixed vector, DS set to 
global data area 

0012H F_INS _ FREEOWNDS Install next free vector, user 
supplies DS 

0012H F_INS _FREEGETDS Install next free vector, system 
supplies DS 

0012H F_INS _FREEGLBDS Install next free vector, DS set 
to global data area 

0012H F_INS_ FIND Search for matching device 
header 

0012H Reserved * 

0012H Reserved * 

0012H F RAM_GET Get EX-BIOS memory pool ad- 
dress and size . 

0012H F RAM_RET Set memory pool address and 
size 

A-8 BIOS Interrupts. 








Table A-3. EX-BIOS Drivers and Functions (Cont.) 


Vector Func. Function 
Address Value Equate 


F_CMOS_GET Read and verify CMOS memory 
F_CMOS_RET Write to CMOS memory 
Reserved * 

Reserved* 

Just returns 

Reserved * 

Reserved * 

Enable keyclick 

Disable keyclick (Default) 
Execute keyclick if enabled 
Enable beep 

Disable beep 

Beep if enabled 

Set beep frequency 

Produce tone, user supplied 
duration and frequency 

| Return next free string index 
Delete bucket string list 

Add bucket to current string list 
Search the list for index, return 
string 

Search list for a string, return 
index 

Reserved * 
















































F_ YIELD 


F_ SND CLICK _ENABLE 
F SND CLICK _ DISABLE 
F SND CLICK 

F SND BEEP ENABLE 
F SND BEEP _ DISABLE 
F SND_BEEP 
F_SND_SET _BEEP 
F_SND_TONE 


F_STR_GET _FREE_INDEX 
F STR DEL _BUCKET 
F_STR_PUT _BUCKET 
F_STR_GET _STRING 


F_STR_GET _ INDEX 


V_ 88259 8259 interrupt controller 
support 

F_ISR Unsupported 

F_SYSTEM System functions 

SF_INIT Initialize HP-HIL IRQ 

SF_ START Enable HP-HIL interrupts 


SF VERSION _ DESC 
F_IO0_CONTROL 


Report HP version number 
Entry point to I/O control 
functions 

Unmask svc /8041 interrupt 
Mask svc/8041 interrupt 
Unmask keyboard INT 9 
interrupt 

Mask keyboard INT 9 interrupt 
Unmask HP-HIL interrupt 
Mask HP-HIL interrupt 
Reserved* 


SF_ENABLE _SVC 
SF DISABLE SVC 
SF_ ENABLE KBD 


SF_DISABLE _KBD 
SF_ENABLE _HPHIL 
SF DISABLE _HPHIL 


V_SINPUT Inquire Commands 

F_ISR Pass ISR event record to physical 
driver 

F_SYSTEM System functions 

SF_INIT Supported 
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BIOS Interrupts 


F_IO_CONTROL 








SF_DEF _LINKS 





SF_GET _LINKS 





SF_SET _LINKS 





F_ INQUIRE 








F_INQUIRE_ ALL 





F_INQUIRE _ FIRST 


V_QWERTY 
F_ISR 
F_SYSTEM 
SF_VERSION _ DESC 
V_SOFTKEY 





F_ISR 
F_ SYSTEM 
SF_INIT 

SF_VERSION _DESC 
V_FUNCTION 


F_ISR 
F_ SYSTEM 
SF_VERSION _ DESC 
V_NUMPAD 

F_ISR 

F_SYSTEM 
SF_VERSION _ DESC 
V_cCCP 


F_ISR 
F_SYSTEM 
SF_VERSION _ DESC 
V_SVIDEO 
F_ISR 

F_ SYSTEM 

F_ IO CONTROL 





SF_VID _ID_HP 





F_REPORT _ ENTRY 


























Table A-3. EX-BIOS Drivers and Functions (Cont.) 


Vector Func. Function 
Address Value Equate Definition 


Entry point to I/O control 
functions 

Set header link fields to system 
defaults 

Return device header link field 
entries 

Set device header link field 
entries 

Return describe record for an 
HP-HIL device 

Return device [Ds for all 
HP-HIL devices present 
Return vector address of first 
HP-HIL device driver 

Report entry point of PGID 
Reserved * 

Typewriter keypad translator 
Translate to PC scan code. 
System functions 

Report HP version number 
Physical HP function key 
translator 

Translate to PC scan code 
System functions 

Driver initialization 

HP version number 
Compatibility function key 
translator 

Logical Interrupt 

System functions 

Report HP version number 
Numeric keypad translator 
Logical interrupt 

System functions 

Report HP version number 
HP cursor control keypad 
translator 

Logical interrupt 

System functions 

Report HP version number 
Video Functions 

Interrupt service routine 
Standard driver functions 
Driver dependent control 
functions 

Returns the value "HP" in BX 
register 












Table A-3. EX-BIOS Drivers and Functions (Cont.) 


Vector Func. Function , 
Address Value Equate Definition 


0054H SF_VID _GET_INFO Return video display adapter 
information 

Set info. on extended control 
register of the Multimode Video 
Adapter 
Modify extended control register 
of Multimode Video Adapter 
Get the resolution of active 
video adaptor 

Set video mode of active Display 
adapter 

Sprite control 














SF_VID _SET_INFO 










SF_VID _MOD_INFO 





























SF_VID _GET_RES 









SF_VID _SET_MODE 







V_STRACK 














F_ISR Update sprite 

F_ SYSTEM System functions 
SF_INIT Initialize driver 
SF_START Start driver 







Set tracking to default state 
Enable tracking 

Disable tracking 

Define sprite masks 

Set max/min horizontal values 
Set max/min vertical values 
Display sprite 

Remove sprite from display 
Application access to touch 
events 

Application access to tablet 
events 

Application access to pointer 
events 
Reserved* 


F_TRACK_INIT 
F_TRACK_ON 
F_TRACK_OFF 
F_DEF_MASKS 
F_SET_LIMITS_X 
F_SET_LIMITS_Y 
F_PUT_SPRITE 
F_REMOVE_ SPRITE 
V_EVENT_TOUCH 


























V_EVENT_TABLET 








V_EVENT_ POINTER 






























HP cursor control keypad 
translator 

Logical interrupt 

System functions 

Return HP version number 
Return untranslated CCP data 
Logical interrupt 

System functions 

Return HP version number 
Translate scancodes from 
numeric keypad 

Logical interrupt 

System functions 

Return HP version number 
Discard CCP and SOFTKEY 
scancodes 


V_CCPCUR 












F_ISR 
F_ SYSTEM 
SF_VERSION_DESC 
V_RAW 

F_ISR 

F_ SYSTEM 
SF_VERSION_ DESC 
V_CCPNUM 





















F_ISR 
F SYSTEM 
SF_VERSION_DESC 
V_OFF 
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Table A-3. EX~BIOS Drivers and Functions (Cont.) 


Vector Func. Function 
Address Value Equate 


009CH F_ISR Logical Interrupt. 

009CH F_SYSTEM System functions 

009CH SF_VERSION__DESC Returns HP version number 
00A2H V_CCPGID Translate CCP data to 
T_REL16 data 

HP and compatibility function 
key translator 
















































OOA8H V_SKEY2FKEY 



















OOA8H F_ISR Logical interrupt 
O0OA8H F_ SYSTEM System functions 
OOA8H SF_VERSION_ DESC Return HP version number 





OOAEH V_ 8041 8041/keyboard interface. 
provides HP extensions to INT 


16H 































OOAEH F_ISR Process ISR event record 
OOAEH F_SYSTEM System functions 

OOAEH SF_INIT Initialize driver 

OOAEH SF_START Driver start-up 

OOAEH SF_ VERSION _ DESC Report HP version number 
OOAEH F_IO_ CONTROL Driver Dependant Functions 
OOAEH Reserved * 


































OOAEH SF_CREAT _INTR Create interval entry 




















OOAEH SF_DELET _INTR Delete interval entry 
OOAEH SF_ENABL _INTR Enable interval 

OOAEH SF_DISBL _INTR Disable interval 

OOAEH SF_SET _RAMSW Set RAM switch to one (1) 
OOAEH SF_CLR _RAMSW Set RAM switch to zero (0) 
OOAEH SF_SET CRTSW Set CRT switch to one (1) 
OOAEH SF_CLR __CRTSW Set CRT switch to zero (0) 
OOAEH SF_ PASS _ THRU Pass data byte to 8042 
QOOAEH Reserved * 













Translate GID info to cursor 
control keypad format 


00B4H 





V_PGID_CCP 


























OOBAH V_LTABLET Application interface to tablet 
OOBAH F_ISR Logical interrupt 

OOBAH F SYSTEM System functions 

OOBAH SF_INIT Initialize the driver data area 
OOBAH SF_START Start driver 

OOBAH SF REPORT STATE Report state of device 

O0OBAH SF_ VERSION _ DESC Report driver version number 


OOBAH Set default logical scaling 
attributes 
Get scaling attributes 


Set scaling attributes 


SF_DEF _ATTR 
















OOBAH 
OOBAH 


SF_GET _ATTR 


SF_SET _ATTR 
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Table A-3. EX-BIOS Drivers and Functions (Cont.) 


Vector Func. Function 
Address Value Equate 












OOBAH F_IO0 CONTROL 


















OOBAH SF_LOCK 
OOBAH SF_UNLOCK 
OOBAH SF_TRACK _ON 
OOBAH SF_TRACK _ OFF 





OOBAH SF_CREATE _EVENT 





OOBAH SF_ EVENT _ON 








OOBAH SF_EVENT _OFF 







OOBAH 
OOBAH 
OOBAH 
00COH 







SF CLIPPING _ON 
SF CLIPPING _ OFF 
F_ SAMPLE 

V_LPOINTER 

























00COH F_ISR 








00COH F_ SYSTEM 
00COH SF_INIT 

00COH SF_START 

00COH SF_REPORT _STATE 
00COH SF_VERSION _ DESC 








00COH SF_DEF _ATTR 















00COH SF_GET _ATTR 

















00COH SF_SET _ATTR 
00COH F_IO_CONTROL 
00COH SF_LOCK 

00COH SF_UNLOCK 
00COH SF_TRACK _ON 
00COH SF_TRACK _ OFF 





00COH SF_CREATE _ EVENT 


00COH 





SF_EVENT _ON 










00COH SF_EVENT _OFF 













00COH 
00COH 
0O0COH 
00C6H 








SF_CLIPPING _ON 
SF CLIPPING _ OFF 
F_ SAMPLE 
V_LTOUCH 

















00C6H F_ISR 






00C6H F_ SYSTEM 
00C6H SF_INIT 
O0C6H SF_ START 





00C6H SF_REPORT _STATE 


I/O control functions 
Unsupported 

Unsupported 

Turn cursor track on 

Turn cursor track off 
Establish a new routine to be 
called on logical device events 
Enable event call to parent 
driver 

Disable event call to parent 
driver 

Enable logical device clipping 
Disable logical device clipping 
Report absolute position of GID 
Application interface to 
Pointer / Mouse 

Logical Interrupt 

System functions 

Initialize the driver data area 
Start driver 

Report state of device 

Report driver version number 
Set default logical scaling 
attributes 

Get scaling attributes 

Set scaling attributes 

1/O control functions 
Unsupported 

Unsupported 

Turn cursor track on 

Turn cursor track off 
Establish a new routine to be 
called on logical device events 
Enable event call to parent 
driver 

Disable event call to parent 
driver 

Enable logical device clipping 
Disable logical device clipping 
Report absolute position GID 
Application interface to 
touchscreen 

Logical interrupt 

System functions 

Initialize the driver data area 
Start driver 

Report state of device 
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Table A~3. EX-BIOS Drivers and Functions (Cont.) 


__VERSION _ DESC 
pe _ATTR 


00C6H 
00C6H 




































00C6H SF_GET _ATTR 
00C6H SF_SET _ATTR 
00C6H F_1IO_CONTROL 
00C6H SF_LOCK 

00C6H SF_UNLOCK 
00C6H SF_TRACK _ON 
00C6H SF_TRACK _ OFF 


00C6H SF_CREATE _ EVENT 















00C6H SF_EVENT _ON 











00C6H SF_EVENT _ OFF 

























O0C6H SF_CLIPPING _ON 
O0C6H SF_CLIPPING _ OFF 
00C6H F_ SAMPLE 

0108H V_NULL 

O10EH 





O114H V__HPHIL 






































O114H F_ISR 


0114H F_ SYSTEM 

O114H SF_INIT 

O114H SF_REPORT _STATE 
O114H SF_ VERSION _ DESC 
O114H SF_OPEN 

O114H SF_CLOSE 

O114H F_10_CONTROL 


O114H SF_CRV _RECONFIGURE 
















O114H 
0114H 


SF_CRV _WR_PROMPTS 
SF_CRV _WR_ACK 











0114H SF_CRV _ REPEAT 
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BIOS Interrupts 


Vector Func. Function 
Address Value Equate Definition 


Report driver version number 
Set default logical scaling 
attributes 

Get scaling attributes 

Set scaling attributes 

I/O control functions 
Unsupported 

Unsupported 

Turn cursor track on 

Turn cursor track off 

Establish a new routine to be 
called on logical device events 
Enable event call to parent 
driver 

L sable event call to parent 
driver 

Enable logical device clipping 
Disable logical device clipping 
Report absolute position of GID 
No driver 

Reserved * 

Setup HP-HIL to INPUT driver 
linkage 

Logical interrupt 

System functions 

Initialize the driver data area 
Report state of device 

Report driver version number 
Driver in open state 

Put driver in closed state 

I/O control to driver 

Force HP-HIL to reconfigure all 
devices 

Write a prompt to a device 
Write an acknowledge to a 
device 

Set either 30Hz or 60Hz repeat 
rate 





Table A-3. EX-BIOS Drivers and Functions (Cont.) 


Function 
Equate 


SF_CRV _DISABLE_REPEAT 
SF_CRV _SELF_TEST 


Vector Func. 
Address Value 














SF_CRV _REPORT_STATUS 









SF_CRV _REPORT_NAME 








SF_GET _DEVTBL 












SF_SET _DEVTBL 
SF_ DEF _DEVTBL 
F GET_BYTE 









F_PUT_BUFFER 























V_SCANDOOR 
F_ISR 

F_ SYSTEM 
SF_INIT 
SF_START 
SF_VERSION_ DESC 
F IO CONTROL 
F_STATE_IOCTL 
SF_GET_ STATE 


























HP-HIL driver vectors 1 thru 7 
F_ISR 

F_SYSTEM 

SF_ INIT 

SF_ START 

SF REPORT STATE 
SF_VERSION _ DESC 
Available Vectors 
















* Vectors marked reserved should not be used. 


at 


Cancel keyboard repeat rate 
Issue self-test command to 
physical device 

Get status from any HP-HIL 
device that needs to report 
Return the ASCII name for a 
device 

Gets physical device table 
address 

Sets physical device table address 
Sets default physical device table 
Read one byte from specified 
HP-HIL device 

Write a string of bytes to 
HP-HIL device 

Reserved * 


Process SCANDOOR interrupt 
System function 

Initialize driver 

Driver start-up 

Reports HP version number 
Driver-dependent function 
State functions 
Get a STATE byte 


Vectors available (16) 





Physical HP-HIL driver vectors 
Logical interrupt 

System functions 

Initialize driver 

Start driver 

Unsupported 

Report HP version number 
Inquiry on availability of free 
vector in HP_ VECTOR 

__ TABLE 


Vectors with addresses xxxH do not have a fixed location. Their location is determined 


at power-on, depending on the system’s configuration. 
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Memory Map 


an 


System Memory Map 


The system maintains ROM and RAM entry point compatibility with the industry standard. Table B-1 
provides a memory map of the first megabyte of memory. 


Interrupt Vectors 


Table B-1. Memory Map 
















































0000:0000H 00000H 003FFH 








STD-BIOS Data Area 0040:0000H 00400H 0051DH 
Scratch 0050:001EH 0051EH 00SFFH 
Bios Stack 0060:0000H 00600H 006FFH 
DOS 0070:0000H 00700H 

Application 0Cc00:0050H 0CO050H nFO00OH 


nFOOOH nFFFFH 

n is dependent upon the - 
amount of memory installed. 
The EX-BIOS takes a mini- 
mum of 1000 hex bytes. 
00000H 3FFFFH 

00000H 7FFFFH 

00000H 9FFFFH 


EX-BIOS System RAM 
















If Max RAM Equal 256KB 
If Max RAM Equal 512KB 
If Max RAM Equal 640KB 









































Boot Address 07C0:0000H 07C00H 

Reserved Video Buffer A000:0000H AO000H AFFFFH 
Monochrome Video Buffer B000:0000H BOOOOH B7FFFH 
Color Video Buffer B800:0000H B&8000H BFFFFH 
Video ROM Space C000:0000H CO000H C7FFFH 
IHV ROM C800:0000H C8000H DFFFFH 
SPU IHV ROM Space E000:0000H EOQO00H EFFFFH 
BIOS ROM F000:0000H FOOOOH FFFFFH 
RESET Vector F000:FFFOH FFFFOH 


Memory Map B-1 


STD-BIOS Data Structures 


The data area for the STD-BIOS is in absolute memory locations 00400H through OOSFFH, which 
conforms to the industry standard. Table B-2 summarizes the assignments within this block of memory. 


A detailed description of these data fields follows the summary. 


400H-407H 
408H-40FH 
410H-416H 
417H-43DH 
43Eh-448H 
449H-466H 
467H-46BH 
46CH-470H 
471H-473H 
474H-477H 
478H-47FH 
480H-483H 
484H-488H 
489H-48AH 
48BH-48BH 
48CH-48FH 
490H-495H 
496H-497H 
498H-4A0H 
4A1H-4A7H 
4A8H-4ABH 
4ACH-4EFH 
4FOH-4FFH 
500H-500H 
S$01H-503H 
504H-504H 
SOSH-5FFH 


Table B-2. STD-BIOS Data Area 


RS-232 Communication Port Addresses 
Parallel Printer Port Addresses 

Equipment Flag 

Keyboard Data Area 

Flexible Disc Data Area 

Video Display Data Area 

Option ROM Data Area 

Timer Data Area 

System Data Flags 

Hard Disc Data Area 

Printer Timeout Counters - 

Keyboard Buffer Pointers 

Enhanced Graphics Adapter (EGA) Data Area 
Reserved for Display Adapters 

Flexible Disc Data Rate Area 

Extended Hard Disc Data Area 

Extended Flexible Disc Data Area 
Keyboard Mode Indicator/LED Data Area 
Real-Time Clock Data Area 

Reserved for Network Adapter Cards 
Pointer to EGA Data Area 

Flexible Disc Expander adapter area (Vectra RS Only) 
Intra-application Communications Area 
Print Screen Status 


| Reserved 


DOS Data Area 
Reserved 


RS-232 Communication Port Addresses 


The I/O port addresses of up to four serial communication adapter ports are stored in these four words. 





40:000H 02 S40_RS232_PORT1_ADR port 1 
40:002H 02 S40_RS232_PORT2_ ADR port 2 
40:004H 92 S40_RS232_PORT3_ ADR port 3 
40:006H 02 S40_RS232_ PORT4 ADR port 4 
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Parallel Printer Port Addresses 


The I/O port addresses of up to four parallel printer adapter ports are stored in these four words. 


40:008H 02 S40_PRINT_PORTI_ADR port | 
40:00AH 02 S40_PRINT_PORT2__ADR port 2 
40:00CH 02 S40_PRINT_PORT3_ ADR port 3 
40:00EH 02 S40_PRINT_PORT4_ADR port 4 


Equipment Byte Data Area 


This data area contains several words describing some of the optional hardware installed in the system. 


40:010H 02 S40_EQUIPMENT_FLAG eae devices word (see Table 
B- 

40:012H 01 S40_MFG_INIT Manufacturing initialization / test 
byte 

40:013H 02 S40_ MEMORY _ SIZE Memory size in Ik bytes 

40:015H 01 S40_MFG_ERR_FLAGI Manufacturing scratchpad 

40:016H 01 S40_MFG_ERR_ FLAG2 Manufacturing error codes 


Table B-3. Equipment Flag (40:010H) 


a 


OFH-OEH no printers installed 

one printer installed 

two printers installed 

three printers installed 
reserved 

no RS-232 ports installed 
one RS-232 port installed 
two RS-232 ports installed 
three RS-232 ports installed 
four RS-232 ports installed 
reserved 



















ODH-0CH 
OBH-09H 
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Table B-3. Equipment Flag (40:010H) (Cont.) 


a 


07H-06H 1 flexible disc drive installed, if bit 0=1 
2 flexible disc drives installed, if bit O=1 

05H-04H video adapter is not monochrome or color 
initial video mode of 40-column color 
initial video mode of 80-column color 


initial video mode of 80-column monochrome 
03H-02H reserved 
O1H math coprocessor (80287 or 80387) not present 
math coprocessor (80287 or 80387) present 
00H no disc drives present 
some number of flexible disc drives present, see 
bits 7-6 





Keyboard Data Area 


This area is used by the keyboard driver to store keyboard states, scancodes and keycodes. 


40:017H 01 S40_KBD_STATEI1 State of special keys: shift, caps, 
etc. (see Table B-4). 

40:018H 01 S40_KBD_STATE2 Secondary state of special keys (see 
Table B-5). 

40:019H 01 S40_ ALT_INPUT _ ACCUM Accumulator for alt/numpad entry 

40:01AH 02 S40 KBD BUF_HEAD Keyboard buffer head pointer 

40:01CH 02 S40_KBD_BUF_ TAIL Keyboard buffer tail pointer 

40:01EH 20 S40_ KBD BUFFER Keyboard buffer, room for 15 
entries+overrun 

40:096H 01 S40_KBD_EXT_STATE! State of extended keyboard process- 


ing (see Table B-10). 
40:097H 01 S40_KBD_ STATUS Keyboard LED status and data 


recieved from keyboard (see Table 
B-11). 
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Table B-4. Keyboard State Mask Byte1 (40:017H) 


Insert state inactive 

Insert state active 

Caps lock state inactive 

Caps lock state active 

Num lock state inactive 

Num lock state active 

Scroll lock state inactive 

Scroll lock state active 

<Alt> key not depressed (inactive) 
<AlIt> key depressed (active) 

<Ctrl> key not depressed (inactive) 
<Ctrl> key depressed (active) 

Left <Shift> key not depressed (inactive) 
Left <Shift> key depressed (active) 
Right <Shift> key not depressed (inactive) 
Right <Shift> key depressed (active) 
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Table B-5. Keyboard State Mask Byte2 (40:018H) 


<Ins> key not depressed 

<Ins> key depressed 

<Caps lock> key not depressed 
<Caps lock> key depressed 

<Num lock> key not depressed 
<Num lock> key depressed 

<Scroll lock> key not depressed 
<Scroll lock> key depressed 

Pause state (<Ctrl>-<Num lock>) inactive 
Pause state active 

<System request> key not depressed 
<System request> key depressed 
left <Alt> key not depressed 

left <Alt> key depressed 

left <Ctri> key not depressed 

left <Ctrl> key depressed 
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Memory Map B-S5 


Flexible Disc Data Area 


This area is used by the flexible disc driver to store information about current drive activity. 


40:03EH 01 S40_ FLOPPY SEEK STAT Drive recalibration status (see 
Table B-6) 
40:03FH 01 S40_ FLOPPY __MOTOR_ STAT Drive motor status (see Table B-7) 
40:040H 01 S40_ FLOPPY TIME OUT Drive timeout counter (see Table 
| B-8) 
40:041H 01 S40_ FLOPPY RETURN_STAT Drive return code/error status 
40:042H 07 S40. FLOPPY CONTRL_ STAT Controller status/hard disc com- 


mand/parm port copies 


Table B-6. Flexible Disc Seek Status Byte (40:03EH) 









Disc hardware interrupt occurred 
Reserved 

Indicates drive 1 needs recalibration before next seek 
Indicates drive 1 does not need recalibration before next seek 
Indicates drive O needs recalibration before next seek 
Indicates drive O does not need recalibration before next seek 








Table B-7. Flexible Disc Motor Status Byte (40:03FH) 


07H Current operation is not a write 
Current operation is a write 
06H Reserved 
05H Drive one is not selected 
Drive one is selected 


04H Drive zero is not selected 
Drive zero is selected 

03H-02H Reserved 

O1H Drive one motor is not running 
Drive one motor is running 

00H Drive zero motor is not running 
Drive zero motor is running 
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07H 
06H 
0SH 
04H-00H 


Seek error; seek to track failed 


Write protect error 


unformatted 


Video Display Data Area 


Controller error; disc controller chip failed 
Bad command; invalid command request 
Address error; address mark on disc not found 


Sector not found; unable to locate sector, disc damaged or 


Media changed; the drive door was opened on a 1.2MB disc drive 
DMA error; DMA failed to respond in time 

Segment wrap; attempt to perform DMA across a segment boundary 
CRC error; CRC check on data failed 


Table B-8. Flexible Disc Drive Error Status (40:041H) 


Timeout error; disc failed to respond in time 








This area is used by the video driver to store current screen parameters and cursor positions. 


40:049H 
40:04AH 
40:04CH 


40:04EH 


40:050H 


40:060H 
40:062H 


40:063H 


40:065H 


40:066H 


01 


02 


02 


02 


10 


02 


01 


02 


01 


01 


S40_CRT_MODE 
S40_CRT_WIDTH 
S40_CRT_LENGTH 


S40 CRT _PAGE_ADR 
S40_CRT_CURSOR _ POS 


S40_CRT_CURSOR _MODE 
S40_CRT_ DISPLAY _PAGE 


S40_CRT_PORT_ADR 


S40_CRT_MODE _SEL_REG 


S40_CRT_PALETTE 


Current video mode 
Current # of screen columns 
Current length of screen in bytes 


Current address of current display 
page 


Cursor coordinates (row, column) 
up to 8 pages 


Current cursor mode setting | 
Current display page 


Base I/O port address for active 
video controller 


Mode select register copy 


Color palette register copy 
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Option ROM Data Area 


This area is used by the POST (SYSGEN) routine. 


40:067H 02 S40_XROM_INIT_ADR 
40:069H 02 S40_XROM_SEGMENT 
40:06BH 01 S40_XROM_INT_FLAG 


Timer Data Area 


This area stores the current timer count and flags. 


40:06CH 02 540_ TIMR_LOW 
40:06EH 02 S40_TIMR_ HIGH 
40:070H 01 S40_ TIMR_OVR_ FLOW 


System Data Flags 


Offset address for optional I/O 
ROM initialization routine 


Segment address for optional I/O 
ROM 


Flag last interrupt that occurred 


Least significant word of timer 
count 


Most significant word of timer 
count 


24-hour timer tick rollover 
counter 


This area used by the system to flag <Ctrl>-<Break> and <Ctrl>-<Alt>-<DEL> requests. 


40:071H 01 S40_SYS_BREAK_ FLAG 


40:072H 02 S40 SYS RESET FLAG 
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System break request flag 


System reset flag 


Hard Disc Data Area 


This area is used by the INT 13H fixed disc driver to store current information about the fixed disc 
controller and status. 


40:074H 01 S40_FD_STATUS Hard disc status of last Int 13H 
operation : 

40:075H 01 S40_ FD COUNT Number of hard discs present 

40:076H 01 S40 FD CONTROL Copy of hard disc controller 
register 

40:077H 01 S40_ FD _PORT_OFFSET Hard disc port offset 


Printer Timeout Counters 


These tables contain timeout counts for the parallel and serial ports. The default value is 14H for the 
parallel printer port and 01H for the serial port. 


40:078H 01 S40_ PRINT_TIMEOUT1 Parallel port 1 timeout count 
40:079H 01 S40_ PRINT_TIMEOUT2 Parallel port 2 timeout count 
40:07AH 01 S40_ PRINT_TIMEOUT3 Parallel port 3 timeout count 
40:07BH 01 S40_ PRINT_TIMEOUT4 Parallel port 4 timeout count 
40:07CH 01 S40_RS232_ TIMEOUT! Serial port 1 timeout count 
40:07DH 01 S40_RS232_ TIMEOUT2 Serial port 2 timeout count 
40:07EH  O1 S40_RS232_ TIMEOUT3 Serial port 3 timeout count 
40:07FH 01 S40 RS232_ TIMEOUT4 Serial port 4 timeout count 


Keyboard Buffer Pointers 
These pointers indicate where in memory the keyboard buffer is, as opposed to the current access points 


to the buffer stored in the pointers above. This allows an application to move and enlarge the keyboard 
buffer. 


40:080H 02 S40 KBD _ BUF_START Pointer to physical start of 
keyboard buffer 


40:082H 02 S40_ KBD _BUF_END Pointer to physical end of 
keyboard buffer 
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Enhanced Graphics Adapter (EGA) Data Area 


This data area is used by the optional EGA driver when present. 


40:084H 1 $40 _EGA_CRT_ ROW _CNT 
40:085H 02 S40_EGA_CHAR_ SIZE 
40:087H  O1 S40_EGA_INFO1 EGA — 
40:088H 01 S40_EGA_INFO2 EGA 


40:089H 02 


Flexible Disc Data Rate Area 


Number of CRT rows minus one 


Number of bytes per character in 
font table 


miscellaneous information 
miscellaneous information 


Reserved 


This data area is used by the flexible disc driver to optimize performance on the 1.2 MB drives by 


keeping track of the last data rate selected for disc access. 


40:08BH Ol S40_FLOPPY_LAST RATE 


Extended Hard Disc Data Area 


40:08CH 01 S40_AFD STATUS REG 
40:083DH 1 S40_AFD_ERROR_REG 
40:08EH O01 S40_AFD_INTR_FLAG 
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Last data rate selected 


Hard disc status reg. copy 
Hard disc error reg. copy 


Hard disc interrupt flag 


Extended Flexible Disc Data Area 


This data area is used by the flexible disc driver to store information about the current media in the 
drives and what operations are being performed on it. 


40:08FH 01 S40_ AFLOPPY_INDICATORS Drive 0 and 1 indicator flags 

40:090H 01 S40_AFLOPPY MEDIA Drive 0 media state (see Table 
B-9) 

40:091H 01 S40_ AFLOPPY_MEDIA1 Drive |! media state 

40:092H 01 S40_AFLOPPY_OPERO Drive 0 operation state 

40:093H 01 S40_AFLOPPY_ OPER! Drive 1 operation state 

40:094H 01 S40_ AFLOPPY_TRACKO Drive 0 current track 

40:095H 01 S40_ AFLOPPY_ TRACK! Dave 1 current track 


Table B-9. Flexible Disc Media Byte (40:090H) 


a 


07H-06H Data transfer rate is 500 KB/sec 
Data transfer rate is 300 KB/sec 
Data transfer rate is 250 KB/sec 
Single step all seeks 

Double step all seeks 

Type of disc in drive unknown 
Type of disc in drive known 
Reserved 

Attempting 360 KB disc in 360 KB drive 
Attempting 360 KB disc in 1.2 MB drive 
Attempting 1.2 MB disc in 1.2 MB drive 
Determined 360 KB disc in 360 KB drive 
Determined 360 KB disc in 1.2 MB drive 
Determined 1.2 MB disc in 1.2 MB drive 















OSH 
















04H 










03H 
02H-00H 










Keyboard Mode Indicator 


This byte is used by the keyboard driver to store the current state of the keyboard LEDs. 


40:096H 01 S40_KBD_EXT_STATEI Keyboard LED flags (see Table 
. B-10) : . 
40:097H 01 S40_KBD_ STATUS Keyboard LED flags (see Table 


B-11) 
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Table B-10. 101-key Keyboard Flags (40:096H) 


Read ID bytes in progress 


First of ID bytes was last 


Force Num Lock if 101- see keyboard is attached This is when 
DOS is loaded or reloaded. Enhan : 


Right <Alt> key status 
Right <Alt> key is pressed 


Right <Ctrl> key status 
Right <Ctrl> key is pressed 


EO was last 


E1! was last 





Table B-11. Keyboard LED Status and Data Area (40:097H) 


Used for a flag to indicate 3 failures of sending data to keyboard 
LED update in progress 

Resend received from keyboard 

Acknowledge received from keyboard 

Reserved (set to 0) 


Caps Lock LED status 
Caps Lock LED on 


Num Lock LED status 
Num Lock LED on 


Scroll Lock LED status 
Scroll Lock LED on 





Note: Applications which modify these bytes may experience difficulty in maintaining synchronization 
between the Cursor Control keypad and the Numeric keypad on the HP Vectra Key 
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Real-time Clock Data Area 


This area is used by the RTC driver to store information needed to interrupt an application waiting on an 


RTC event. 


40:098H 


40:09AH 


40:09CH 


40:09EH 


40:0A0H 


40:0AI1H 


02 


02 


02 


02 


01 


07 


S40_RTC_WAIT _OFFSET 
S40_RTC_WAIT _SEGMENT 
S40_RTC_WAIT _CNT_LOW 
S40_RTC_WAIT _CNT_HIGH 


S40_RTC_WAIT _ACTV_FLG 


Pointer to EGA Data Area 


40:0A8H 
40:0ACH 


04 


2C 


S40_EGA_TBL_PTR 


Flexible Disc Expander Adapter Data Area 


Offset address of user wait flag 
Segment address of user wait flag 
Low word of wait count 

High word of wait count 

Wait active flag 


Reserved 


Pointer to table of EGA pointers 
Reserved 


This applies solely to the Vectra RS systems, and only when the Flexible Disc Expander adapter card is 
installed. This data area is used by the flexible disc expander driver to store information about the 
current media in the drives and what operations are being performed on it. 


40:0D8H 


40:0D9H 


40:0DAH 


40:0DBH 


40:0DCH 


40:0DDH 


40:0DEH 


01 


01 


01 


01 


01 


01 


01 


S40_ AFLOPPY INDICATORS 


540_ AFLOPPY__MEDIA2 


S40_AFLOPPY_MEDIA3 
S40_AFLOPPY_OPER2 
S40__AFLOPPY_OPER3 
S40_AFLOPPY_TRACK2 


S40_ AFLOPPY _TRACK3 


Drive 2 and 3 indicator flags 


Drive 2 media state (see Table 
B-9) 


Drive 3 media state 
Drive 2 operation state 
Drive 3 operation state 
Drive 2 current track 


Drive 3 current track 
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intra-application Communications Area 
Used by applications to communicate with each other and with themselves from one work session to 


another. 


40:0FO 10 S40_INTRA_APPL "Available to any application 


Print Screen Status 


40:100H 01 S40_PSCRN_ STATUS Flag for print screen in progress 
(see Table B-11) 
40:101H 03 3 Reserved 


Table B-12, Print Screen Status Byte (40:100H) 


0 Print not in progress 
1 


Print in progress 
FFH Error during print 


07H-00H 
















DOS Data Area 


The following data areas are used by DOS to provide status information on single-drive systems. 


40:104H 01 S40_ SINGLE DRV _ STAT Status of flexible disc for single 
drive systems, i.e., currently drive 
A: or B: 

40:105H 1A Reserved 


Reserved Data Areas 


The following areas are reserved and should not be used under any circumstances: 


40:089H 02 
40:0A1H 07 
40:0ACH = Ze 
40:0DFH 11 
40:101H 03 
40:105H 1A 
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EX-BIOS Data Area Map 


Figure B-1 shows the EX-BIOS RAM space, which contains the HP_VECTOR_ TABLE, the EX-BIOS 
memory pool, and the EX-BIOS global data area. 


HP_VECTOR_TABLE 
HP_ENTRY_CODE 


EX-BIOS 
Memory 
Pool 


HP_VECTOR_TABLE 
HP_ENTRY's CS:0 (a.) 







HP_ENTRY_CODE 
HP_ENTRY’s CS:IP (b.) 


“Max DS” (c.) 








EX-BIOS 
Memory 
Pool 


“Last used DS” (d.) 


EX-BIOS Resident 
Driver's Data 
Segments 


EX-BIOS Global 
Data Segment 






V_SYSTEM's DS (e.) 





TOP of RAM (f) 


Figure B-1. EX-BIOS Data Area Layout 
The following notes correspond to the letters in Figure B-1. 


a. This address is the segment (CS) value stored in the second word of the HP_ ENTRY interrupt 
vector (default O6FH); the HP_VECTOR_ TABLE is at offset zero. This value may also be obtained 
from the V_ SYSTEM driver, using function F_INS_BASEHPVT. 


b. This address is the offset (IP) value stored in the first word of the HP_ ENTRY interrupt vector 
(default O6FH). This address (CS:IP) represents the end of the HP_VECTOR_ TABLE and points to 
the EX-BIOS’s HP_ENTRY_ CODE. 


c. This address represents the last allocatable data segment ("MAX DS") value available from the 
EX-BIOS memory pool. This address may be obtained as well as allocated from the EX-BIOS 
V_SYSTEM driver. See F_RAM_ GET and F_RAM_ RET in Chapter 8. 


d. This address is passed to drivers requesting memory from the EX-BIOS memory pool. Drivers must 
first subtract the size of their data segment from the "last used DS" value to get an addressable data 
area. The new "last used DS" is returned to the EX-BIOS using the F_RAM_RET function. 


e. This address represents the EX-BIOS global data area used by drivers and services that share data. 
This address is the DS value stored in the HP_VECTOR_ TABLE for the V_SYSTEM driver. 


f. Top of RAM is the last address in memory. HP Vectra series of computers are shipped with 640KB 
of system memory, so this value is 9FFFFH. The data region between Top of RAM and the base of 
HP _VECTOR_ TABLE is not directly available to applications. In the base system this region is 4KB 
long. However, since a user can reconfigure standard RAM in the Vectra series of computers (to 
256KB, or 512KB via a jumper on the Processor PCA of the Vectra ES, and 512KB via a switch on 
the Processor PCA of the Vectra QS and RS), this region may need to be lengthened. 
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Option ROM Data Segments 


An option ROM which does not have available on-board RAM can get memory in the manner described 
above. However, the problem arises as to how the option. ROM is to ’remember’ the data segment if it 
doesn’t have any RAM to save the segment in. This problem usually can be solved since most option 
ROMs are accessed through the software interrupt mechanism. The option ROM adapter simply directs its 
entry point software interrupt vector to its EX-BIOS RAM data segment, which in turn jumps to the 
option ROM’s entry point. That is, 


CPU INT nn -> EX-BIOS data segment -> option ROM 


PUSH CS 
POP DS 3; Load option ROM DS 
JMP FAR ROM ENTRY POINT 


EX-BIOS Global Data Area 


The EX-BIOS global data area is shared between several EX-BIOS drivers. It contains temporary and 
permanent variables required by the EX-BIOS to function properly. Some of these variables can be 
modified by application programs. As with the STD-BIOS data area, care should be taken when modifying 
the EX-BIOS data area. 


The EX-BIOS global data area can be found by calling the V_ SYSTEM driver, with the function 
F_INS_BASEHPVT. The EX-BIOS global data area segment will be returned in the DS register. Table 
B-13 defines the contents of this area. 


Table B-13. EX-BIOS Global Data Area 


T_STR_NEXT The next unused 
_ INDEX string index 
number. 


Reserved 


20H and up Reserved 
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ROM BIOS Memory Map 


Table B-14 lists the compatible ROM entry points. The programmer should not access these entry points 
directly. 


Table B-14. Rom Entry Points 


es 


F000:E2C3 


F000:FF54 
F000:F065 
F000:F84D 
F000:F841 
F000:EC5S9 
F000:E739 
F000:F859 
F000:E82E 
- F000:EFD2 
F000:FF53 
F000:E6F2 
F000:FE6E 
F000:FF53 
F000:FF53 
F000:FOA4 


0000:0522 


F000:0000 


Non-maskable 
interrupt 

Print screen 
Video 

Equipment check 
Memory size 
Flexible/hard disc 
Serial 

System functions 
Keyboard 

Printer 

Reserved 

Boot 

Time and date 
Keyboard break 
Timer tick 

Video parameter 
table 

Flexible disc param- 
eter table 
Graphics character 
table 
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Product Identification 


The following are Product Identification Strings. Application designers should use the product 
identification byte to differentiate among the various HP Vectra family of personal computers. The 
machine capability marker can be used to indicate a specific hardware or ROM BIOS capability which 
may apply across more than one product identification code. 


ROM version independent information: 


OF 000: OOF 4H DB High Processor Clock Rate Processor speed in 
MHz - exception: the 
value OFFH means 8 MHz 
OF 000: OOF SH DB Low Processor Clock Rate . 


OF O00: OOF 8H DB ‘HP’ HP Vectra PC ID 
OF O00: OOF AH DB XXXXXXXXB Product identification 
OF 000: OOF BH DB XXXXXXXXB Machine capability marker 


ROM version dependent information: 


OF 000: OOF CH DW PPSSH Version number 
OF 000: OOF EH DB YYH ROM release year since 
1960 stored in BCD 
OF 000: OOF FH DB NN Week of the year stored 
. in BCD 


Industry Standard PC ID: 


OFOOO:FFFEH DB OFCH IBM-AT Compatible PC 


Product Identification Definitions 


Processor Clock Rate 

All Vectras (except for the original Vectra PC) set their clock rate bytes to their clock speeds in MHz. 
Machines which have a single clock rate should set both the primary and secondary rate bytes to the same 
value. 


OF000:00F4H = High processor clock rate (primary) 
Length = one byte 


OF000:00F5H = Low processor clock rate (secondary) 
Length = one byte 
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Processor Clock Rates for HP Vectra Series of Computers 


Vectra ES O8H (8 MHz) O8H (8&8 MHz) 






























Vectra ES/ 12 OCH (12 MHz) O8H (8 MHz) 
Vectra QS/16, RS/16 10H (16 MHz) O8H (8 MHz) 
Vectra QS/20, RS/20 14H (20 MHz) O8H (8 MHz) 
Vectra RS/20C 14H (20 MHz) OSH (5 MHz) 
Vectra RS/25C (25 MHz) (5 MHz) 


HP Vectra PC ID 


The HP Vectra PC ID flag is used to validate the ROM BIOS Identification Block. The flag should be 
tested prior to examining the other bytes of the block. 


OF000:00FAH = Product Identification 
Length = one byte 


Bits: 


| |------ > 00000 - Original Vectra PC 
| 00001 - Vectra ES/12 

| 00010 - Vectra RS/20 

| 00011 - Portable Vectra CS 
| 00100 - Vectra ES 

| 00101 - Vectra CS 

| 00110 - Vectra RS/16 

| 00111 - Vectra QS/16 

| 01000 - Vectra QS/20 

| 01001 - Vectra RS/20C 

| 01010 - Vectra RS/25C 

| 01011 - Vectra LS/12 

| 01100 through 11111 - Reserved 

| 


| ------------------- > 000 - 80286 


001 - 8088 
010 - 8086 
011 - 80386 


100 through 111 - Reserved 
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Machine wapapillty Marker 


OFO00:00FBH = Machine capability evee 
Length = one byte 


Bits: 


| |--> 1.44 MB flexible discs supported 
| with automatic media sense 

| reported via INT 13 function 8H. 
| 


lost ee cn ueeee > Reserved, set to 0. 


BIOS Version Number 


OFO00:00FCH = BIOS version number 
Length = two bytes 


Encoding is as follows: 
DW PPSS 


Where PP = Primary version number 
SS = Secondary version number 


For example, BIOS release A.01.05 would be expressed as: 
DW 0105 


Note that when using DEBUG to look at the bytes, the numbers will be reversed (05 01 ). 
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Year of the ROM BIOS Release (in BCD) 


OFO00:00FEH = Year of ROM BIOS release in BCD. 
Length = one byte 


Encoded as follows: 
DB VV 


Where VV is the difference of the current year and 1960, expressed in 
BCD. 


For example, if the current year is 1987, the entry would be 1987 minus 1960 which is equal to 27H, 
expressed in BCD as: 


DB 27H 


Week of the ROM BIOS Release (in BCD) 


OFO00:00FFH = Week of the ROM BIOS release in BCD. 
Length = one byte 


Encoded as follows: 
DB NN 


Where NN is the week in which the BIOS ROMs were released to manufacturing. 
The range is (OOH - 51H), expressed in BCD. 


For example, if the ROMs were released in week 15, the entry would be 15H in BCD, expressed as: 


DB 15H 
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CMOS Memory Layout and Real-Time Clock 





The real-time clock chip contains 64 bytes of non-volatile (CMOS) memory. Values saved in this 
memory area are not destroyed when the system is powered off. Table C-1 defines the use of the 
Real-time Clock and CMOS memory area. 


Table C-1. CMOS Memory and Real-time Clock 


CMOS Application 
Address 


* RTC current second 

* RTC second alarm value 

* RTC current minute 

* RTC minute alarm value 

* RTC current hour 

* RTC hour alarm value 

* RTC current day of the week 

* RTC current day of the month 

* RTC current month 

* RTC current year 

* RTC status register A 

* RTC status register B 

* RTC status register C 

* RTC status register D 

* Diagnostic status byte 

* Shutdown status byte 

Flexible disc drive type (A: and B:) 

Reserved 

Hard Disc Type for drives C: and D: (1 through 14) 
Reserved 

Equipment byte 

Low base memory 

High base memory 

Extended memory size (low byte) 

Extended memory size (high byte) 

Extended Hard Disc Type for drive C: (16 through 255) 
Extended Hard Disc Type for drive D: (16 through 255) 
Reserved 

2-byte industry standard CMOS checksum for bytes 10H to 2DH 
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Table C-1. CMOS Memory and Real-time Clock (Cont.) 


CMOS Application 
Address 


30H * Extended memory size (low byte, defined by POST) 
* Extended memory size (high byte) 

* Date century byte 

* Information flags 

* Reserved 
* Reserved 










* These bytes are not included in the industry standard CMOS checksum 


Real-Time Clock/CMOS Access 


Port 70H and port 71H provide the interface to the real-time clock and CMOS memory controller. Port. 
70H is used to specify the byte address to read or write. Port 71H is used to pass the data. For example, 
to read the equipment byte, the programmer would write 14H to port 70H, then read the data byte from 
port 71H. A read or write to port 71H must always be preceeded by a write to port 70H. 


Real-Time Clock (CMOS Address OOH-ODH) 


The real-time clock (RTC) chip maintains the current date and time, even when the system is powered 
off. Four registers are initialized by the SETUP program when the user sets the current date and time. 
These registers are detailed in Tables C-2, C-3, C-4 and C-S. 


Table C-2, CMOS_RTC_REGA (CMOS Address 0AH) 


7 The current date and time is available to read 
6-4 
3-0 


The current date and time are not available to read because an up- 
C-2 CMOS Memory Layout and Real-Time Clock 









date of these values is in progress 





Time divider selection bits to indicate what time base frequency is 
being used. This field is set to 2H to indicate that a 32.768 kHz 
crystal is providing the time base. 








Rate selection bits to specify output square wave frequency. This 
field is set to 06H to select a square wave frequency of 1.024 kHz, 
or a periodic interrupt rate of 976.562 microseconds. 











Update clock normally (default) 
Suspend clock updates . 


Disable periodic interrupts (default) 
Enable periodic interrupts 


Disable alarm interrupts (default) 
Enable alarm interrupts 


Do not generate an interrupt when the current update cycle com- 
pletes (default) 
Generate an interrupt each time a clock update completes 


Disable square wave output (default) 
Enable square wave output 


Store date and time in BCD (Binary Coded Decimal) (default) 
Store date and time as binary integers 


Places hours byte in 12-hour mode 
Places hours byte in 24-hour mode (default) 


Disable daylight savings (default) 
Enable daylight savings 





Table C-4. CMOS_RTC_REGC (CMOS Address 0CH) 


No interrupts are currently asserted 
The RTC is asserting an interrupt due to either the alarm, periodic 
interrupt, or update ended. 


No periodic interrupt has occurred since the last read of this bit. 
A periodic interrupt has occurred, read only and cleared by read. 


No alarm interrupt has occurred since the last read of this bit. 
An alarm interrupt has occurred, read only and cleared by read. 


No update ended interrupt has occurred since the last read of the bit. 
An update ended interrupt has occurred, read only and cleared by 
read. 


Reserved 
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Table C-5. CMOS_RTC_REGD (CMOS Address 0DH) 


Power was lost to the RTC chip since the last read of this bit. 
The RTC chip has not lost power since the last read of this bit. 


Read only, set to | after read. 


Reserved 





Diagnostic Status Byte (CMOS Address OEH) 


This byte is set by the POST routine to flag errors detected during power on. The contents of this oe 
are detailed in Table C-6. 


Table C-6. CMOS_DIAGNOSTIC_STATUS (CMOS Address 0EH) 


Power to RTC failed 
Bad industry standard CMOS checksum 


Configuration inconsistency 


Memory size does not match 


Hard disc failed initialization 
Invalid CMOS 


Reserved 





System Shutdown Byte (CMOS Address OFH) 


This byte is used by the system power-on sequence to determine what action is to be taken upon return 
from protected mode. The details of this byte are shown in Table C-7. 
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Table C-7. CMOS_SHUTDOWN_ BYTE (CMOS Address 0FH) 


Perform power-on reset sequence 
INT 19H (reboot) 


Flush keyboard and jump indirect via double word 40:67H 


Reserved - 


Used by POST during test of protected mode RAM 
Used for INT 15H support (block move) 
Jump indirect via double word at 40:67H 


(Same as values 0-3) 





Flexible Disc Descriptor Byte (CMOS Address 10H) 


This byte is initialized by the SETUP program and indicates what types of flexible disc drives are 
installed. The details of this byte are shown in Table C-8. 


Table C-8. CMOS_FDC_ TYPE (CMOS Address 10H) 


a 


No drive installed as drive A 

360 KB drive installed as drive A 
1.2 MB drive installed as drive A 

3.5~-inch drive installed as drive A 


No drive installed as drive B 


360 KB drive installed as drive B 


1.2 MB drive installed as drive B 


3.5-inch drive installed as drive B 
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CMOS Hard Disc Type (CMOS Address 12H) 


CMOS_FIXED_DISC_ TYPE, (CMOS Address 12H), defines the type of the first and second hard disc 
drive installed. | . 


00000000 through 00001111 define Hard Disc Drive Types 1 through 14. See Chapter 7 for more 
information. 


Equipment Byte (CMOS Address 14H) 


This byte is used to initialize STD-BIOS RAM location 40:0010H. This is the value returned by the 
STD-BIOS interrupt INT 11 (get current equipment). The details of this byte are shown in Table C-9. 


Table C-9. CMOS_EQ_ BYTE (CMOS Address 14H) 


a 


One drive installed 

Two drives installed 

Primary display is 40 column color 
Primary display is 80 column color 
Primary display is 80 sein monochrome 


Reserved 


80287 or 80387 installed 


At least one flexible disc installed 





System Base Memory Size (CMOS Address 15H-16H) 


This value represents the amount of base (DOS-addressable) memory installed in the system minus the 
amount of RAM used by the EX-BIOS data area. Three base memory configurations are valid: 


0100H = 256 KB of base memory installed (Vectra ES series only) 
0200H = 512 KB of base memory installed 
0280H = 640 KB of base memory installed 


Note that Vectra series of personal computers are shipped with 640 KB of base memory; however, these 
systems may be configured via jumpers or switches to the lower amounts listed. 
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The actual stored value will be adjusted to leave space for the EX-BIOS data area. For example, the value 
may be OOFCH instead of 0100H, indicating that the system is configured for 256 KB of base memory 
but the EX-BIOS data area is using 4 KB of it. 


CMOS_BASE_MEMORY_ LSB (CMOS Address = 15H) 
CMOS_BASE_MEMORY_ MSB (CMOS Address = 16H) 


System Extended Memory Size (CMOS Address 17H-18H) 


These values are initialized by the SETUP program to the user specified Extended memory size from zero 
to 15 MB in 512 KB increments. For example: 


0200 = 512 KB of Extended memory (0.5 MB) 

0400 = 1024 KB of Extended memory (1.0 MB) 

0600 = 1536 KB of Extended memory (1.5 MB) 

through 

3A00 = 14848 KB of Extended memory (14.5 MB) 

3C00 = 15360 KB of Extended memory (15.0 MB) 

Note that Extended memory is memory above one megabyte. 


CMOS_EXT_MEMORY_LSB (CMOS Address = 17H) 
CMOS_EXT_MEMORY_MSB (CMOS Address = 18H) 


Extended Hard Disc Type for Drive C: (CMOS Address 19H) 
Bit 7-0 defines the Hard Disc Type of the first hard disc installed (drive C:): 


00010000 to 11111111 define types 16 through 255. (The SETUP Program Guide in your computer’s 
Setting Up Vectra binder contains a table listing hard disc drive type characteristics.) 


Extended Hard Disc Type for Drive D: (CMOS Address 1AH) 
Bit 7-0 defines the Hard Disc Type of the second hard disc installed (drive D:): 


00010000 to LLL11111 define types 16 through 255. (The SETUP Program Guide in your computer’s 
Setting Up Vectra binder contains a table listing hard disc drive type characteristics.) 


STD-BIOS Checksum Word (CMOS Address 2EH-2FH) 

This word contains the checksum which is used to verify the contents of the STD-BIOS CMOS data 
locations. This checksum is computed each time one of these locations is modified using an EX-BIOS 
CMOS function. If the EX-BIOS is not used for CMOS update then it is the programmer’s responsibility 
to calculate and replace the STD-BIOS checksum. 


CMOS_STD_BIOS_CRC = [(10]+[11]+[{12]+. . .+[2DH]: 16-bit carryout 
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Low and High Extended Memory Byte (CMOS Address 30H-31H) 


These bytes reflect the total extended memory above the 1MB address space determined at POST. 
Extended memory size can be determined through system INT 15. 


Address 30H, Low extended memory size: Bit 7-0. 
Address 31H, High extended memory size: Bit 7-0. 


Valid sizes are: 

0200H = 512K of Extended memory. (0.5 MB) 
0400H = 1024K of Extended memory. (1.0 MB) 
0600H = 1536K of Extended memory. (1.5 MB) 


through 
3COOH = 15360 KB of Extended memory (15 MB, maximum) 


Date Century Byte (CMOS Address 32H) 
This byte reflects the value for the century expressed in the BCD. 


BCD value for the century (BIOS interface to read and set): Bit 7-0. 


Test Information Byte (CMOS Address 33H) 


Bit seven of this byte is initialized by the boot process to indicate that 640 KB of base memory is 
installed. The details of this byte are shown in Table C-10. 


Table C-10. CMOS_TEST_INFO (CMOS Address 33H) 


Indicates top 128K of base memory is installed 


Reserved 
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1/O Port Map 





Appendix D describes the 1/O map of the system. Table D-! lists the I/O map of all devices integrated 
in the System Processing Unit (SPU). Table D-2 lists the recommended I/O port assignments for devices 
in adapter cards. Subsequent sections in the appendix describe the SPU built-in devices individually. I/O 
devices in adapter cards are described fully in the Vectra Accessories Technical Reference Manual (for 
either the Vectra ES or RS series). 


Table D-1.SPU I/O Map 


1/O Description 
Address 


000-01FH 
020-03FH 
040-05FH 
060H 
061H 
064H 
068H 
06C-06FH 
070H 
071H 
078H 
080-09FH 
0A0-OBFH 
0C0-ODFH 
OFOH 
OF 1H 
OF 8-OFFH 


First DMA Controller (8237A) 

Master Interrupt Controller (8259A) 
Timer Controller (8254) 

Keyboard Buffer Full port 

SPU Control port 

Keyboard Output Buffer Full (OBF) port 
Keyboard Extended Command port 


HP-HIL Controller ports 

RTC address / NMI disable port 

RTC data 

Hard Reset NMI enable port 

DMA Page Registers ports 

Slave Interrupt Controller (8259A) 

Second DMA Controller (8237A) 

Clear (80287 or 80387 only) Coprocessor port 
Reset (80287 or 80387 only) Coprocessor port 
Math (80287 or 80387 only) Coprocessor 
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Table D-2. Adapter I/O Map 


1/0 Description 
Address 


1FO-1F8H 
200-207H © 
278-27FH 
2E8-2EFH 
2F8-2FFH 
300-31FH 
320-323H 
378-37FH 
380-38FH 
3A0-3AFH 
3B0-3B7H 
3BC-3BFH 
3C0-3CFH 
3D0-3DFH 
3E8-3EFH 
3F0-3F7H 
3F8-3FFH 


Hard Disc controller 

Game I/O adapter 

Parallel port 2 

Serial port 3 (COM4) 

Serial port 1 (COM2) 

Prototype adapter card 

Reserved 

Parallel port ! 

SDLC, bisynch 2 

Bisynch 1 

Monochrome display adapter 
Monochrome display/Parallel adapter 
Enhanced Graphics adapter (EGA) 
Color Graphics adapter 

Serial port 2 (COM3) 

Flexible Disc controller 

Serial port 0 (COM1) 





DMA Channel Controller 


The SPU supports seven DMA channels using two Intel 8237A compatable DMA controllers in cascade 
mode. For each DMA channel there is a page register used to extend the addressing range of the channel 
to 16 MB. The only type of DMA transfer allowed is "I/O to memory". No “I/O to I/O" or "memory to 
memory" transfers are allowed due to the way the hardware is configured. For more detailed information 
on the 8237A DMA controllers see Intel’s The 8086 Family User's Manual. Table D-3 summarizes how 
the DMA channels are allocated. 


Table D-3. DMA Channel Allocation 


First DMA controller (used for 8 bit transfers): 
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Spare. 

Usually datacomm. 
Flexible disc I/O. 
Spare. 


Second DMA controller (used for 16 bit transfers): 


Cascade from first DMA controller. 
Spare. 
Spare. 
Spare. 
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Appendix D describes the I/O map of the system. Table D-1 lists the I/O map of all devices integrated 
in the System Processing Unit (SPU). Table D-2 lists the recommended I/O port assignments for devices 
in adapter cards. Subsequent sections in the appendix describe the SPU built-in devices individually. 1/O 
devices in adapter cards are described fully in the Vectra Accessories Technical Reference Manual. 


Table D-1. SPUI/O Map 


1/O Description 
Address 


000-01FH 
020-03FH 
040-05FH 
060H 
061H 
064H 
068H 
06C-06FH 
070H 
071H 
078H 
080-09FH 
0A0-OBFH 
0CO-ODFH 
OFOH 
OF 1H 
OF8-OFFH 





First DMA Controller (8237A) 

Master Interrupt Controller (8259A) 

Timer Controller (8254) 

Keyboard Buffer Full port 

SPU Control port 

Keyboard Output Buffer Full (OBF) port 
Keyboard Extended Command port 

HP-HIL Controller ports 

RTC address / NMI disable port 

RTC data 

Hard Reset NMI enable port 

DMA Page Registers ports 

Slave Interrupt Controller (8259A) 

Second DMA Controller (8237A) 

Clear (80287 or 80387 only) Coprocessor port 
Reset (80287 or 80387 only) Coprocessor port 
Math (80287 or 80387 only) Coprocessor 
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Table D-2. Adapter I/O Map 


1/O Description 
- Address 

























































1FO-1F8H Hard Disc controller 

200-207H Game I/O adapter 

278-27FH Parallel port 2 

2E8-2EFH Serial port 3 (COM4) 

2F8-2FFH Serial port 1 (COM2) 

300-31FH Prototype adapter card 

320-323H Reserved 

378-37FH Parallel port 1 

380-38FH SDLC, bisynch 2 

3A0-3AFH Bisynch 1 

3B0-3B7H Monochrome display adapter 
3BC-3BFH Monochrome display /Parallel adapter 
3C0-3CFH Enhanced Graphics adapter (EGA) 
3D0-3DFH Color Graphics adapter 

3E8-3EFH Serial port 2 (COM3) 

3FO-3F7H Flexible Disc controller 


3F8-3FFH Serial port 0 (COM1) 





DMA Channel Controller 


The SPU supports seven DMA channels using two Intel 8237A compatable DMA controllers in cascade 
mode. For each DMA channel there is a page register used to extend the addressing range of the channel 
to 16 MB. The only type of DMA transfer allowed is "I/O to memory". No "I/O to I/O" or "memory to 
memory" transfers are allowed due to the way the hardware is configured. For more detailed information 
on the 8237A DMA controllers see Intel’s The 8086 Family User’s Manual. Table D-3 summarizes how 
the DMA channels are allocated. 


Table D-~3. DMA Channel Allocation 


First DMA controller (used for 8 bit transfers): 


Spare. 

Usually datacomm. 
Flexible disc I/O. 
Spare. 


Second DMA controller (used for 16 bit transfers): 


Cascade from first DMA controller. 
Spare. 
Spare. 
Spare. 
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1/O Port Addresses for DMA Controllers 


Table D-4 shows the I/O port addresses for the page register and DMA controllers used when writing the 
DMA addresses. 


Table D-4.1/0O Port Addresses and Address Lines 


a DMA page register I/O Ports: 
1/O Port Address Lines 


A23-A16 

A23-A16 byte transfers 
A23-A16 

A23-A16 

Not connected 

A23-A17 

A23-A17 word transfers 
A23-A17 

Used for RAM refresh 


Pel DMA Controller I/O Ports: . ; 


000H address register (A15-A0) 
001H byte count register 
002H address register (A15-A0O) 
003H byte count register 
Zz 004H address register (A15-A0O) 
005H byte count register 
006H address register (A15-A0) 
007H byte count register 
4 OCOH address register (A16-A1) ; 
0C2H word count register . 
0C4H address register (A16-A1) | 
0C6H word count register 

































O0C8H address register (A16-A1) a 
OCAH word count register 

1. OCCH address register (A16-A1) 
OCEH word count register 3 


EG 
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Notes: 


Channel 4 (first channel on the second DMA controller) is used to cascade the first DMA controller and 
it must not be programmed for DMA transfers. 


Channels 5 through 7 are word-wide channels so the address lines used are Al through A23. Address line 
AO is always forced to zero. The address register on these channels provides address lines Al6 through Al, 
and address lines A23 through A1l7 come from bits 7 through | of the page register. Bit 0 of the page 
register is not used. Care should be taken in making sure that the counts and addresses are in words 
rather than bytes. 

Table D-5 lists I/O ports used for writing commands to the DMA controllers. 


Table D-S5. DMA Controller Command I /O Ports 


. Contrl. Contrl. 
1 2 1/O Write 1/O Read 


Command Register Status Register 
Request Register illegal 
Single Mask Register illegal 


Mode Register illegal 
Clear Byte Pointer Flag illegal 
Master Clear Command Temporary Register 
Clear Mask Command illegal 
Multi-Mask Kegister illegal 





8259A Interrupt Controllers 


The system has two 8259A interrupt controllers. They are arranged as a master interrupt controller and a 
slave that is cascaded through the master. Table D-6 shows the I/O ports for these interrupt controllers 
and how they are cascaded. 


Table D-6. 8259A Interrupt Controller I/O Ports 


a 
20H OAOH 
21H OA1H 


Table D-7 shows how the master and slave controllers are connected. The Interrupt Requests (IRQ) are 
numbered sequentially starting with the master 8259 controller and followed by the slave. 









Command Register 
Interrupt Mask 
Register 
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Table D-7. 8259A Master to Slave Connections. 


Master’s IRQ Interrupt Request Description 


IRQO(08H) Timer 
IRQ1(09H) Keyboard OBF 
IRQ2(0AH)<--[Slave IRQ] —. ==" ooo age rved 
IRQO8(70H) ee _.Real Time Clock 
IRQO9(71H). -| SW Redirected 
IRQ10(72H).... _Seriat Port 2 (COM3) 
IRQ11(73H) Serial Port 3 (COM4) 
IRQ12(74H) Reserved 
IRQ13(75H) Coprocessor 
IRQ 14(76H) Hard Disc 
IRQ15(77H) Reserved 
IRQ3(0BH) Serial Port 1 (COM2) 
IRQ4(0CH) Serial Port 0 (COM1) 
IRQ5(0DH) Parallel Port 2 
IRQ6(O0EH) Flexible Disc 
IRQ7(OFH) Parallel Port 1 













Note: The numbers in parentheses are the interrupt vector numbers generated by the IRQs. 
The following example shows how the 8259A controllers are programmed on initialization: 


CLI ; Disable interrupts 
PROGRAM_MASTER: 
MOV AL, 11H ; ICW1: Initialization Command 
OUT 20H,AL ; 
JMP $+2 
MOV AL,O8H ; Interrupt Vector Base at O8H 
OUT 21H,AL 
JMP $+2 
MOV AL,O4H ; Define master with slave 
OUT 21H,AL 3; at IRQ2 
JMP $+2 
MOV AL,O1H ; 8086/88 Mode 
OUT 21H,AL 
JMP $+2 


PROGRAM STD SLAVE: 
MOV AL, 11H 3; ICW1: Initialization Command 
OUT OAOH,AL 
JMP $+2 
MOV AL,70H ; Interrupt Vector Base at 70H 
OUT OA1H,AL~ 
JMP $+2 
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MOV AL,O2H ; Slave ID number 
OUT OA1H,AL 

JMP $+2 

MOV AL,O1H ; 8086/88 Mode 

OUT OA1H,AL 

JMP $+2 oy 

STI ; Re-enable interrupts 


8254 Timer Controller (I/O Ports 40H through 43H) 


The system contains an Intel Programmable Interval Timer 8254. The timer controller consists of three 
separate timer channels; timer channels 0, 1 and 2. Channel 0 provides the BIOS with a programmable 
time interval. Channel | provides the memory refresh signal of the dynamic RAMs in the system. 
Channel 2 generates a fixed frequency envelope to the sound generation circuit. 


SL I OE aT EI TD TS TO POTD OS TE TC ISIE I IE IT I PC I RE CAE 


WARNING 


Timer channel 1 should not be used. Writing to this channel may cause loss 
of data in system memory. 


SSS I LEI Sa TEL LE TT NEI TE ITT I EI EI IAT NS RON AICO 


The timer chip interfaces to the CPU via 4 I/O ports: 


1/O Port 


Counter data for timer 0. 
Counter data for timer 1. 
Counter data for timer 2. 
The control register for all three timers. 





See Intel’s The 8086 Family User's Manual for more details of the 8254 timer controller. 


Keyboard Data Buffer (60H) 


The keyboard data buffer is read by the CPU when the keyboard asserts the OBF interrupt. The OBF 
signal is automatically cleared when the data buffer is read. See Chapter 5 for more information about 
the keyboard data buffer. 
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SPU Control Port (61H) 


The SPU Control Port (61H) is a bi-directional buffer which latches an assortment of unrelated signals. 
Table D-8 describes the bit values contained in this buffer. 


Table D-8. PORT 61H Bit Values 


When the CPU reads port 61H: 


SPU Status Port Definition 


When the CPU writes port 61H: 
SPU Control Port Description 


ca 
Not used | 
Disable and clear I/O channel check. | 
Disable and clear on-board parity NMI 
Enable the data from timer channel 2 to drive speaker circuit. 
Enable gate to timer channel 2. (speaker data) 
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Parity error in on-board system ram 
I/O channel check error has occurred 
Output from timer channel 2 
Refresh detect; toggles once per refresh cycle 
I/O channel check NMI latch (See Figure D-2) 
Disabled 

I/O channel check is enabled 

SPU RAM parity error latch (See Figure D~2) 
Disabled 


Parity error is enabled 


Speaker data from timer channel 2 1s enabled to drive speaker 
circuit. 


Gate to timer channel 2 1s enabled 


Speaker Control 


Figure D-1 shows the relationship of the timer channel 2 and the rest of the speaker circuit. 


VO port 61h, bit 0 gate 
1.190 MHz clock output 





to speaker 
via driver 
circuits 


VO port 61h, bit 1 


Figure D-1. Speaker Control Circuit 


The sound-related EX-BIOS functions are the recommended method of accessing the speaker functions 
(see Chapter 8). 


Keyboard I/O Ports 
Keyboard Command Port (64H): This port is Used to write commands to the 8042 keyboard controller. 


Keyboard Extended Command Port (68H): This port provides a data/command path to the 8042 not 
conflicting with the industry standard I/O ports 60H and 64H. 


HP-HIL Controller (6CH through 6FH): This set of I/O ports provides the communication mechanism to 
the HP-HIL controller. 


Real-Time Clock Ports 


Real-Time Clock and CMOS RAM ports 70H and 71H provide the interface to the MC146818 real-time 
clock (RTC). See Appendix C for further details. 


Hard Reset Enable Port 


Hard Reset Enable Register (Port 78H): This write-only port enables the hard reset line from the 
HP-HIL controller. Table D-9 shows the bit definitions for this port. 
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Table D-9. Hard Reset Enable Register 


Enable hard reset from HP-HIL controller chip. 


Disable and clear hard reset from HP-HIL controller chip. 


Reserved. 





NMI Sources and Involved I/O Ports 


The non-maskable interrupt (NMI) of the CPU is attached to circuitry which allows multiple sources to 
cause an NMI. Each of these sources can be disabled individually as well as collectively. 


Figure D-2 is a block diagram of the NMI circuit. 


(Parity Enable) 
Port 61H 
bit 2 latch 


Parity 
Check 
Line 


(VO Channel Check Enable) 


: 


Port 61H 

he =e) 
Channel 
Check 


(Hard Reset Enable) 


Port 78H 
bh 7 


HP-HIL Input 
Device 


(NMI Enable) 
Port 70H 
bit 7 


Figure D-2. NMI Circuit Block Diagram 
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Default Device Mapping 





Table E-1 describes the device mappings which are set up during SYSGEN. The default mapping device is 
listed first. Other mappable devices are listed following the default device. 


Table E-1. Input System 


Physical Device Logical Device Mappable Driver 


Mouse Cursor Control Pad V_PGID_CCP 
V_LPOINTER 
Rotary Knob 


V_LTOUCH 
Touchscreen 














V_LTABLET 










V_PGID_CCP 
V_LPOINTER 
V_LTOUCH 

V_LTABLET 


Cursor Control Pad 















V_LTOUCH 
V_LPOINTER 
V_PGID_CCP 
V_LTABLET 
V_LTABLET 
V_LPOINTER 
V_LTOUCH 
V_PGID_CCP 


Vectra Keyboard/DIN Keyboard Subsystem V_ 8042 
Compatibility Function keys V_FUNCTION 


HP Function keys SKEY2FKEY 
V_OFF 
V_RAW 


Touchscreen 



















Tablet Cursor Control Pad 
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Table E-1. Input System (Cont.) 


Physical Device Logical Device Mappable Driver 
Typewriter Keypad V_QWERTY non-mappable 











Cursor Control Keypad vV_CCP V_CCPCUR 
| V_OFF 
V_RAW 

V_CCPGID 

. (if installed) 


Discs 
DISC A: | Flexible Disc 0 Upper Drive 
DISC B: Flexible Disc 1 Lower Drive 
DISC C: Internal Hard Disc 
DISC D: External Disc 
DISC E: RAM disc 


Discs on the system are only mappable using the MS-DOS ASSIGN command. 


Character I/O Devices 


LPTI: OR PRN: 

COMI: Serial Port 0 

COM2?: Serial Port 1 

COM3: Serial Port 2 

COMS: Serial Port 3 

LPT 1: or PRN: Parallel Port 0 
LPT2: Parallel Port 1 

LPT3: Parallel Port 2 


These ports are only mappable using the MS-DOS MODE command. 
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Driver Writer’s Guide 





This appendix describes how a programmer can add drivers to the ROM BIOS. One of the important 
features of the EX-BIOS is the ease with which it can be expanded. This capability allows programmers to 
take full advantage of HP system components (such as the HP-HIL touchscreen, mouse, tablet, etc.). In 
addition, the EX-BIOS architecture provides a simple, yet powerful way to integrate OEM and 
third-party products into the system. This appendix is intended for all programmers and advanced users 
who wish to utilize EX-BIOS capabilities not supported by system software. It assumes that the reader is 
familiar with the contents of Chapters 1 through 8, iAPX286 or iAPX386 programming, DOS concepts in 
general, and DOS installable device drivers in particular. The reader should consult the publications listed 
under the References section at the end of this manual for additional information on these topics. 


Introduction 


This appendix presents two examples of how drivers that interface to the system’s EX-BIOS can be 
written. All aspects of how a driver gets connected and used through the EX-BIOS are discussed. 


The typical steps involved in connecting a driver into the EX-BIOS are: 


m A driver added to the system can be one of three types: ROM driver, MS-DOS installable device 
driver or MS-DOS command that executes and stays resident. 


w= The driver gets called to initialize. At this point the driver will determine what machine it is 
executing on, obtain memory for its data segment, get an EX-BIOS vector address assigned and be 
added to the HP_ VECTOR_ TABLE. 


m Any time after initialization, the driver can respond to service requests in two ways. It responds to a 
hardware service request when it is called with its F_ISR (AH = 0) function or it responds to an 


application service request when it is called with any other driver-specific function. 


The above sequence is a general description of a driver’s life cycle. It is not necessary that all drivers 
follow the same steps. The sections below outline what are the necessary elements of an EX-BIOS driver. 


Note: For a detailed explanation of the calls to V_ SYSTEM (i.e., INT V_SYSTEM) used below see 
Chapter 8. 
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Installation of Device Drivers 


Each type of device driver is installed in a different manner depending on how it is brought into the 
system. There are three ways that an EX-BIOS driver can be installed in the system. An I/O adapter card 
can have an EX-BIOS driver which can be installed in the system when the adapter’s ROM gets called to 
initialize during the SYSGEN process. The adapter’s initialization routines can use all of the V_SYSTEM 
functions to properly connect the driver. Note that because the adapter’s code modules are initialized 
during the system generation process (SYSGEN), an EX-BIOS driver on an adapter card can not depend 
on other EX-BIOS drivers already being present and initialized (V_ SYSTEM is the only driver usable at 
this point). 


An MS-DOS installable device driver can also install an EX-BIOS driver. The driver must have two 
interfaces, one driver interface for MS-DOS and one driver interface for the EX-BIOS functions. This 
type of EX-BIOS driver can use all other EX-BIOS drivers already present in the system. 


Finally an MS-DOS command that stays resident can also be used to install an EX-BIOS driver. This 


driver can use all previously installed EX-BIOS drivers. This is the preferred method of installing 
EX-BIOS drivers since it only requires the EX-BIOS driver interface and functions. 


Initialization 


This section covers the possible steps the driver must take to insure proper initialization. 


Product Identification 


This section discusses several methods available through ROM BIOS functions for software to determine 
whether its host is an HP Vectra. 


HP Vectra Feature /Revision Identification (V_SCOPY): 


The V_SCOPY (00H) vector entry has a data segment (DS) that points to the system’s copyright string. 
The driver can look at this string to determine if the machine is an HP Vectra. The following example 
illustrates how to get this string: 


MOV BP, V_SCOPY Call the COPYRIGHT 


PUSH DS 3 vector which will set 
CALL SYSCALL 3; the DS and return 
PUSH DS 3; Save DS of copyright 
3; string in ES. 
POP ES 3; ES:0 is address 
; of string 
POP DS 3 Recover old DS. 


HP Vectra Indicator Word, Revision Word, and Date Codes 


At ROM address OFOOF8H, the HP Vectra series of personal computers have the following data. 


F-2 Driver Writer’s Guide 


OFOO0:00F8 DB ‘HP’ 

OFO00:00FA Product ID byte (Bits 7-5 = CPU, Bits 4-0 = SPU) 
OFO00:00FB Machine Capability Marker 

OFO00:00FC Version Number 

OFO00:00FE Date Code 


For a complete definition of product description code, refer to 
the "Product Identification” section in Appendix B. 


This code can be used to discern the HP Vectra series of personal computers from other industry-standard 
products and thus take advantage of the unique features of the HP Vectra series of personal computers. 
(However, this method is not the preferred method.) 

STD-BIOS Extended Functions 

The STD-BIOS Extended Functions Fnn INQUIRE (6FOOH) indicate to the calling application that 
STD-BIOS extended functions are loaded and have not been replaced. The STD-BIOS drivers listed in 
Table F~1 below support this function. 


Table F-1. STD-BIOS Drivers that Support Fnn_INQUIRE 


VIDEO 


SERIAL 
KEYBOARD 
PRINTER 





To find out if the STD-BIOS extensions for the Video driver are in place, use the following code: 


MOV AX, F10_ INQUIRE ; Call video 
function (6F00) 
Make sure 
BX <> “HP’ 
Interrupt 10H 
Are video 
extensions 
3 present? 

JE VIDEO EXTENSIONS PRESENT 
VIDEO EXTENSIONS NOT_PRESENT: 


MOV BX, OFFFFH 


INT INT VIDEO 
CMP BX, ‘HP’ 


eo we we we we we we 


VIDEO EXTENSIONS PRESENT: 


Obtaining Memory From the EX-BIOS 


The system allows EX-BIOS drivers to obtain limited amounts of memory independent of the operating 
system. This feature is especially important for I/O ROM adapters since their cost can be reduced if they 
do not require dedicated RAM. When the I/O ROM module is initialized, it can ask for EX-BIOS 
memory. 
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This feature of the EX-BIOS system can also be utilized by application programs and system software. 
Any program needing a limited amount of RAM outside the operating system domain can obtain this 
from the EX-BIOS system. 


The functions F_RAM_GET and F_RAM_RET in the V_SYSTEM driver can be used to manipulate 
the EX-BIOS free memory. The driver can also use the installation functions F_INS_FREEGETDS or 
F_INS_FIXGETDS to obtain free memory. See Chapter 8 for more details of these functions. 


Getting a Free Vector 


In order for an application to access an EX-BIOS driver it must call the driver through the 
HP_VECTOR_ TABLE. Thus, each driver must request a free vector from this table. 


To get a free vector from the HP_VECTOR_ TABLE, a driver can use the function 
F_INS_XCHGFREE, F_INS_FREEOWNDS, F_INS_FREEGETDS or F_INS_FREEGLBDS in the 
V_SYSTEM driver. Each of these functions installs the driver at the next available free vector. (See 
Table 9-3 "V_SYSTEM Driver Function Code Summary" for the numerical values of the above 
functions. 


Once the driver has a vector address installed in the table, an application can call the driver by loading 
BP with the vector address of the driver and doing a CALL SYSCALL. 


EX-BIOS Driver Functions 


EX-BIOS drivers support a standard set of functions and subfunctions. Nine standard function codes are 
defined, and several of these functions have subfunctions defined within them. These functions and 
subfunctions are summarized in Table F-2. A detailed description of each defined function and 
subfunction follows. 


If a driver receives a function it does not implement, it must return a status code of 
RS__UNSUPPORTED (02H) in the AH register. This lets the application know that the driver has not 
handled this function, but that it can continue if it is appropriate. This protocol frees the driver from 
having to implement all the defined functions and allows applications to call drivers in a consistent way. 


If a driver receives a function code that it does not implement, it may also "delegate" the function to 
another driver. A driver may be written so that it calls another driver when it receives an 
unimplemented function or subfunction request. 


Programmers may write drivers that implement functions and subfunctions that are not defined. 
However, two guidelines should be observed when defining additional functions or subfunctions. First, 
whenever possible, newly defined function or subfunction numbers should not conflict with existing 
numbers. Secondly, function and subfunction numbers should be consistent between drivers of the same 
class. : 
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Table F-2. EX-BIOS Driver Function Code Summary 


Register Function (AH) / 
AH AL Subfunction (AL) Definition 





























F_ISR Responds to a logical Interrupt Service Request (ISR). 

F_ SYSTEM Executes one of several standard subfunctions. 

SF_INIT* Starts the initialization of a driver. 

SF_START* Completes the initialization process of the driver. 

SF_REPORT Reports the state of the driver. 

_ STATE 

SF_ VERSION Reports the revision number and datecode of the driver. 
DESC * 
















Reports the default configuration of the driver. 
Reports the current configuration of the driver. 

Overrides the current configuration of the driver. 

Reserves the driver for exclusive access. Requests any 
resources required by the driver. 

Releases the driver from exclusive access. 

Reports to the driver that a requested timeout has 
occurred. 

Reports to the driver that a requested 60 Hz interval has 
expired. 

Performs a hardware test. 

Executes the following subfunctions and any driver depen- 
dant subfunctions. 

Reserves the sub-address device specified for exclusive 
access. 

Releases the sub-address specified from the exclusive 
access. 

Writes a byte of data. 

Reads a byte of data. 

Writes a variable length buffer of data (supported by 
character devices). 

Writes a fixed length buffer of data (supported by block 
devices). 

Reads a variable length buffer of data (supported by 
character devices). 

Reads a fixed length block of data (supported by block 
devices). 

Writes a word of data. 

Reads a word of data. 


SF_DEF _ATTR 
SF_GET _ATTR 
SF_SET _ATTR 
SF_OPEN 











SF_CLOSE 
SF_ TIMEOUT 





SF_INTERVAL 











SF_TEST 
F_ IO CONTROL 
























SF_LOCK 








SF_ UNLOCK 





F_PUT_BYTE 
F_GET_BYTE 
F PUT_BUFFER 











F_PUT_BLOCK 






F_GET_BUFFER 










F_GET_ BLOCK 






F_PUT_WORD 
F_ GET WORD 





Note: Functions marked with an asterisk (*) should be supported by all drivers. These functions may 
perform no useful function. However, they should return a status code of RS_ DONE (O6H) or 
RS_ SUCCESSFUL (0) as opposed to RS_UNSUPPORTED (02H). 


The following is a list of predefined driver function codes and a brief description of their purpose and 
parameters: 
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EX-BIOS Driver Function Definitions 


F__ISR (AH = OOH) 


This function processes either a logical or a physical interrupt event. It reports whether or not it handled 
the event through its Return Status Code (see Table F-2). The driver may require the service of its 
parent driver to handle the interrupt. 


EX-~BIOS drivers do not usually enable interrupts (STI) while processing this function code. Drivers should 
service this interrupt within 250 microseconds or maintain interrupts off for no more than 250 
microseconds at a time. Drivers should expect 40 bytes of stack when called. If a driver enables interrupts 
it must provide 40 bytes of stack for other ISR’s. 


On Entry: AH 


F_ISR (00H) 


On Exit: AH = RS SUCCESSFUL (00H) 
or RS NOT SERVICED (04H) 


F SYSTEM (AH = 02H) 


This function contains a set of subfunctions that execute system-oriented tasks. These subfunctions 
include driver setup, configuration, and control. The F_SYSTEM subfunctions are described in detail 
below. 


SF__INIT (AX = 0200H) 


This starts the initialization process of a driver. The function does not return to the caller until the 
driver is ready to be called by another driver. All system services (V_ SYSTEM) are assumed to be 
operational when a driver is called by this function. 


The driver is responsible for a brief hardware check and for reporting RS_ FAIL if the test failed. A 
driver need only execute a test procedure if it directly interfaces to physical hardware. 


If the driver requires EX-BIOS RAM, the BX and DX registers can be used to reserve available memory 
(see Chapter 8). 


On Entry: AH = F SYSTEM (02H) 


AL = SF_INIT (00H) 
BX = "last used DS" 
BP = Driver’s vector address 


Return Status Code 
New “last used DS" 


On Exit: AH 
BX 


Recommended for hardware test failure: 


AH = RS_FAIL (02H) 
ES:DI = pointer to a string of information 
about the nature of the error 
CX = length of the string pointed to 


by ES:DI 
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SF__ START (AX = 0202H) 


This function notifies a driver that it may call other drivers for any additional setup it may require. All 
other ROM drivers and ROM services are present, active and capable of being accessed. This function does 
not usually return to the caller until all its internal and external setup is complete. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_START (02H) 
Driver’s vector address 


On Exit: AH = Return Status Code 


SF__REPORT _ STATE (AX = 0204H) 


Reports a word of status or state information to the caller in the DX register. The format of the state 
information will be presented bit wise and should be presented in the same format for all drivers of the 
same class. 


On Entry: AH = F_ SYSTEM (02H) 
AL = SF_REPORT_STATE (04H) 
BP = Driver’s vector address 


On Exit: AH 
BX 


Return Status Code 
State of Driver 


SF__VERSION _ DESC (AX = 0206H) 


Reports the version number of the driver code and an optional describe record which contains other 
driver-dependent information. 


On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_VERSION DESC (06H) 
Driver’s vector address 


On Exit: AH 
BX 


Return Status Code 

Version number, 

YYWW is a BCD number where, 
WW is the week of the year 
YY is the number of years 

since 1960 
Number of bytes in data buffer 
Pointer to describe record 


CX 
ES:DI 


SF__DEF__ATTR (AX = 0208H) 


Returns a pointer in ES:DI to a parameter block containing the driver’s default configuration values. This 
function does not set the defaults; it only reports them. 
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On Entry: AH 
AL 
BP 


F_SYSTEM (02H) 
SF_DEF_ATTR (08H) 
Driver’s vector address 


On Exit: AH 
CX 
ES:DI 


Return Status Code 
Number of bytes in data buffer 
Pointer to a data buffer 


SF__GET__ATTR (AX = 020AH) 


Reports the configuration values defined by the parameter block. Baud rates, HP-IB addresses, etc. may 
be reported by this command. 


On Entry: AH = F_SYSTEM (02H) 


AL = SF_GET_ATTR (OAH) 
BP = Driver’s vector address 
On Exit: AH Return Status Code 


CX 
ES:DI 


Number of bytes in data buffer 
Pointer to a data buffer 


SF__SET__ATTR (AX = 020CH) 


Sets the parameter block defined by ES:DI as the configuration values. Baud rates, HP-IB addresses, etc. 
may be defined by this command. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_SET ATTR (OCH) 
BP = Driver’s vector address 
CX = Number of bytes in data buffer 
ES:DI = Pointer to a data buffer 


On Exit: AH 
ES:DI 


Return Status Code 
Pointer to a data buffer 


SF__ OPEN (AX = 020EH) 


Allows exclusive access to this driver. All resources required for driver operation will be acquired at this 
time. This function has special meaning for the the HP-HIL driver, the HP-IB driver and the HP-IL 
driver. Since these drivers support shared interfaces, control of the resource HP-HIL (obtained from the 
driver V_HPHIL), control of the HP-IB (in contention with other PCs on the bus), and control of the 
HP-IL (in contention with other PCs on the loop) is requested and obtained. Control should be kept until 
a single operation is performed on the resource. A status of RS BUSY will be reported if the device has 
previously been opened. RS_SUCCESSFUL will be reported if the device is available. A busy status does 
not prevent access to the driver. All functions will execute (perhaps improperly) whether a driver has 
been opened or not. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_OPEN (OEH) 
BP = 


Driver’s vector address 


On Exit: AH = Return Status Code 
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SF__CLOSE (AX = 0210H) 


Closes the requested resource. Again, this function has special meaning for the interface class of devices, 
HP-IB, HP-HIL, and HP-IL. The driver goes to a state where control can be obtained by or passed to 
another controller. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_CLOSE (10H) 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


SF__ TIMEOUT (AX = 0212H) 
Reports to the driver that its timer event number has occurred. 
On Entry: AH 


AL 
BP 


F_SYSTEM (02H) 
SF_TIMEOUT (12H) 
Driver’s vector address 


On Exit: AH = Return Status Code 


SF__INTERVAL (AX = 0214H) 


Reports to the driver that its interval event number has occurred. 


On Entry: AH = F_SYSTEM (02H) 
AL = SF_INTERVAL (14H) 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


SF__ TEST (AX = 0216H) 


The driver performs a hardware test and reports RS_ FAIL if the test failed. A driver need only execute 
a test procedure if it directly interfaces to physical hardware. 


On Entry: AH 
AL 
BP 


F SYSTEM (02H) 
SF_TEST (16H) 
Driver’s vector address 


On Exit: AH = Return Status Code 
On test failure: 


CX = The length of the string pointed 
to by ES:DI 

Pointer to a string of 
information about the nature of 
the error 


ES:DI 
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F__10__CONTROL (AH = 04H) 


This is a collection of driver-dependant control subfunctions. Drivers of the same class should implement 
similar subfunctions. The following is a list of predefined driver subfunction codes and a brief description 


of their purpose and parameters: 


SF__LOCK (AX = 0400H) 


Reserves the indicated addresses on an already allocated driver for exclusive access. 


On Entry: AH = F_IO CONTROL (04H) 


AL = SF_LOCK (00H) 
DH,DL = Major and minor address 
(Optional) 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


SF__UNLOCK (AX = 0402H) 
Releases the indicated address from exclusive access. 


On Entry: AH = F_IO CONTROL (04H) 


AL = SF_UNLOCK (02H) 
DH,DOL = Major and minor address 
(optional) 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


F  PUT_BYTE CAH = 06H) 
This is a generic put data byte function. 
On Entry: AH 


AL 
BP 


F_PUT_BYTE (06H) 
Data byte 
Driver’s vector address 


On Exit: AH = Return Status Code 


F GET BYTE (AH = 08H) 
This is a generic get data byte function. 


On Entry: AH = F_GET_ BYTE (08H ) 
BP = Driver’s vector address 


Return Status Code 
Data byte 


On Exit: AH 
AL 
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F _PUT__BUFFER OR F__PUT__BLOCK (AH = OAH) 


Puts a number of bytes to a device. The difference between a buffer device and a block device is that a 
buffer device accepts variable length records, while a block device accepts fixed length records. Thus, a 
printer is a data buffer device and a disc is a block device. Usually, a block device requires more 
parameters than a data buffer device; consequently, there is a different format for parameter passing. 


F PUT__BUFFER (AH = OAH) 


This is a generic put data buffer or put data block function. Either a string write or a disc block write 
could use this function. 


On Entry: AH = F_PUT_ BUFFER (OAH ) 
CX = Data byte count or block count 
ES:DI = Pointer to data buffer 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


F PUT_ BLOCK (AH = OAH) 


Writes a fixed block of data to a block device. 


On Entry: AH = F_PUT_BLOCK (OAH) 
DH = Major number 
DL = Minor number 
ES:DI = Command Block 


Word 0,1: Data transfer address 
Word 0,2: Block count 

Word 0,3: Block address LSW 
Word 0,4: Block address MSW 
(for some devices this word 

is ignored). 


BP = Driver’s vector address 


Return Status Code 
Operation status 


On Exit: AH 
BX 


F_ GET _ BUFFER OR F_GET_ BLOCK (AH = OCH) 
F_GET_ BUFFER (AH = OCH) 


This is a generic get buffer or get block function. Either string reads or disc block reads could use this 
function. 
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On Entry: AH = F_GET_ BUFFER (OCH) 
CX = Byte count or block count 
DS:SI = Pointer to data buffer 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


F_GET__BLOCK (AH = OCH) 


Reads a fixed length block of data from a device. 


On Entry: AH = F_GET_BLOCK (OCH) 
DH = Major number 
DL = Minor number 
ES:DI = Command Block 


Word 0,1: Data transfer address 
Word 0,2: Block count 

Word 0,3: Block address LSW 
Word 0,4: Block address MSW 
(For some devices this word 

is ignored). 


BP = Driver’s vector address 
On Exit: AH = Return Status Code 

BX = Operation status 
F__PUT__WORD (AH = OEH) 


This is a generic put word of data function. If the destination device is byte wide, then the byte in the 
DL register is written first, followed by the byte in the DH register. 


On Entry: AH = F_PUT WORD (OEH) 
DX = Data word 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 


F_GET__WORD (AH = 10H) 


This is a generic get word of data function. If the source device is byte wide, then the first byte is read 
into the DL register, and the second byte is read into the DH register. | 


On Entry: AH = F_GET_WORD (10H) 
BP = Driver’s vector address 


On Exit: AH = Return Status Code 
DX = Data word 


F-12 Driver Writer's Guide 


Return Status Codes 
The conventions for assigning return status codes are as follows: 
If possible, use a return status that has already been defined. 
Error conditions should be reported with a negative byte (OFEH--080H). 
Status or exceptional conditions "soft errors" should be reported with a positive byte (02--7EH). 
Good Status is always reported as 00H. 
Table F-3 summarizes the already assigned status codes. 


Table F-3. EX-BIOS Assigned Return Status Codes 


RS _ SUCCESSFUL The requested function executed correctly. 
RS UNSUPPORTED The requested function or subfunction is 
. not implemented or is unsupported. 
RS_NOT_SERVICED The requested function was not executed by 
this driver. Any drivers which are chained 
on this interrupt vector should be called in 
turn until a return status of 
RS SUCCESSFUL or some other error is 
reported. 
RS_ DONE This return status is used by the Input 
System translators to indicate that an ISR 
event has been handled and no further 
processing should be done. 
OFEH (-02H) RS_ FAIL The driver failed the operation in an error 
state. 
OFCH (-04H) RS_ TIMEOUT The device timed out on a physical event in 
an error state. 
OFAH (-06H) RS_ BAD The driver received a bad parameter. 
__PARAMETER 
OF8H (-08H) RS__ BUSY The requested driver is busy. 
OF6H (-O0AH) RS _NO_VECTOR HP_VECTOR_ TABLE is out of RAM or 
room for more drivers. 
OF4H (-OCH) RS_ OFFLINE Device is offline. 
OF2H (-0OEH) RS _OUT_OF _ PAPER Device is out of paper. 
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Driver Headers 


The EX-BIOS driver header (HP_SHEADER) is a formatted data structure similar to the DOS device 
driver’s header. It defines the attributes of a driver, defines the linkage of a driver and identifies the 
driver. It also allows the programmer to define how the driver links with other drivers. 


All EX-BIOS drivers must have an HP_SHEADER. Programmers are not required to provide a complete 
HP_SHEADER to use the HP_VECTOR_ TABLE. But, if they choose to take advantage of the advanced 
features of the EX-BIOS the programmer must implement a complete HP_SHEADER. Table F-4 shows a 
complete driver header and what fields must be present. 


Table F~4. Driver Header Table 


DH_ATR* Driver Attribute Field 

DH_NAME_INDEX Driver String Index Field 

DH__V_DEFAULT Driver’s Default Logical Device 
Vector 


DH_P_CLASS**# Driver’s Parent Class 
DH_C_CLASS** Driver’s Child Class 
DH_V_PARENT** Driver’s Parent Vector 
DH_V_CHILD** Driver’s Child Vector 
DH_MAJOR** Subaddress Field 

DH_ MINOR ** Subaddress Field 





*This is the only field required for a driver to be in the HP_VECTOR_TABLE. 
**These fields are only required by drivers that want to do device mapping. 


HP_ SHEADER Fields 


DH__ATR: Each bit in the DH_ATR field indicates a property of the driver for device mapping 
purposes. These bits are defined in Table F-S. 


Table F-5. Device Attributes Bits 


The following bytes form a 
complete driver header. 

The bytes that follow are not a 
driver header. 













ATR_DEVCFG Reserved. 





ATR_ISR The driver can be mapped with 


DH_V_ PARENT. 
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Table F-5. Device Attributes Bits (Cont.) 


ATR_ENTRY The driver can be mapped with 
DH_V_CHILD. 


ATR_ TYPE _ MASK These three bits indicate the 
driver type. 

ATR_RSVD This is a reserved vector. 

ATR_FREE This is a free vector. The 
V_ SYSTEM service allocates 
free vectors to new drivers upon 
request. 

ATR_SRVC This driver is an EX-BIOS 
service. 

ATR_LOG This is a logical driver. Its map- 
ping direction is from parent to 
child. 

ATR_IND This is a mappable driver that 
cannot be the last in the chain 

. of drivers. 

ATR_ BOT This is a mappable driver that 1s 
the last in a chain of drivers. 
This driver can only be a child 
driver. This driver maps with 
ATR_LOG, ATR_IND and 
ATR_ BOT drivers. 

ATR_INP This driver is an input driver 
and is mappable. 

Reserved 


ATR_STRING Reserved 


ATR_MAP _CALL This driver’s SF_ START sub- 
function should be called when- 
ever the driver is remapped. 


ATR_SUBADD These bits specify what type of 
major and minor addresses the 
driver requires. 

ATR_NOADDR The driver does not require any 

| address. 

ATR_MAJOR This driver requires that a major 
address be specified and stored 
in the parent driver’s 
DH_MAJOR header record. The 
range of possible major addresses 
is 0 through the contents of this 
header’s DH_ MAJOR. 
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Table F-5. Device Attributes Bits (Cont.) 


ATR_MINOR This driver requires that a 
minor address be specified and 
stored in the parent driver’s 
DH_ MINOR header record. The 
range of possible MINOR ad- 
dresses is 0 through the contents 
of this header’s DH _ MINOR. A 
driver cannot require a minor 
address unless it also requires a 
major address. 

This driver requires a major ad- 
dress, a minor address, and a 
mid address. The minor address 
field is split into an upper and a 
lower nibble, with the upper 
nibble indicating the mid address 
and the lower nibble indicating 
the minor address. The range of 
addresses possible is specified by 
the child physical driver. 




























ATR_MID 





















This driver cannot be shared be- 
tween several parent drivers. 


ATR_PSHARE 










This driver cannot be shared be- 
tween several child drivers. 


ATR_CSHARE 













This driver header is in ROM 
and cannot be altered unless 
copied to RAM. | Reserved 


ATR_ROM 







ATR_YIELD Reserved. 






Reserved 


DH_NAME_ INDEX: The DH_NAME_ INDEX is used to derive the localization string 
index of the driver. This is given by the function 
F_STR_GET_STRING in the V_SYSTEM driver. See Chapter 8 
for additional information. 


DH_V_DEFAULT: —— The DH_V_DEFAULT field contains the driver’s default vector 


address. 
DH_P_CLASS and In conjunction, these fields indicate which drivers may be mapped 
DH_C_CLASS: together. DH_P CLASS and DH_C__CLASS are bit masks. Each 


bit position represents a set of drivers. If a bit is set then the driver 
is in that set of drivers. The DH_P CLASS field indicates a driver 
is in from O to 16 different driver sets. A driver can only map to 
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another driver if its DH_P CLASS field matches at least one bit 
position of another driver’s DH_C_CLASS field. Furthermore, 
DH_ATR field is another condition of mapping. The bits are 
defined in Table F-6. 


Table F-6. Class Bit Positions 










This set of drivers maps to the 
fl through f8 softkeys of the 
keyboard. 

Keyboard (this is not the device 
accessed through INT 16). 
Cursor pad device (for example, 
V__CCPCUR, V_CCP NUM, 
V_OFF, V_RAW, V_CCP, © 
V_ FUNCTION). 

This set of devices map to the 
console device. 

Serial output device, which may 
be capable of limited input. 
Reserved 

An interface class controlling 
multiple resources transparent to 
the operating system. It provides 
major, middle, and minor ad- 
dress modes for the calling ap- 
plication or driver. Examples are 
the HP-HIL driver, the HPIB 
driver, and the HPIL driver. 
Serial output device filter. This 
driver can be mapped in be- 
tween a logical driver and a 
physical driver and it can trans- 
late from one character set to 
another. 

Addressed block device. 

Logical device used as the 
priority boot device. If set on a 
physical device, the device is 
capable of being a boot device. 
Typically a physical driver 
would have both the CL_ BOOT 
bit set and the CL_BLK bit set. 









CL_KBD 







































CL_CCP 












CL_CON 











CL_BYTE 






CL_COMM 
CL_INTERFACE 
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Table F-6. Class Bit Positions (Cont.) 


Logical graphics input device 
(for example V_LTABLET, 
V__LPOINTER, physical GID 
devices and the keyboard 
driver). This class maps to logi- 
cal devices which are not the 
child of another driver. 

This class of driver can map to a 
device which is the child of 
another driver. 

This class is reserved for all 
drivers which can map to an 
event. 

Physical touch device (for ex- 
ample, physical GID drivers or 
V_LTOUCH). 

Reserved 

Class Extension Bit 

Special Group Classes 

This device maps to all other 
devices (V_ PNULL). 

This device maps to no other 
driver. 

















CL_PGID 
















CL_GID 











CL_ PTS 



















CL_01 
CL_00 










CL_ ALL 













CL_NULL 






DH_V_ PARENT: The DH_V_PARENT field contains a vector to the driver that is called 
when the current driver receives an F_ISR function code that it cannot 
or doesn’t know how to process. 

DH_V_ CHILD: The DH__V_CHILD field contains a vector to the driver that is called if 
this driver decides it cannot handle the request function (as long as that 
function is not F_ISR). 

DH__MAJOR: Major address range. 

DH_MINOR: Minor address range. 


See the HP_SHEADER macro definition in the equate files listed in Appendix E. 


F-18 Driver Writer's Guide 


Driver Mapping 


Two drivers may be mapped together if the drivers have matching parent and child class records. The 
mapping rule for the drivers is defined in Table F-7. 


Table F-7 PARENT /CHILD Driver Mapping Rules 


Child 
EI Connection Rule 


Drivers are not to be connected 


Child’s DH_ V_PARENT <-- parent’s vector address 
Drivers can not be connected 

Child’s DH_V_ PARENT <-- parent’s vector address 
Drivers are not connected 

Parent’s DH_V_CHILD <-- child’s vector address 
Parent’s DH_V__CHILD <-- child’s vector address 
Drivers are not connected 

Child’s DH_V_PARENT <-- parent’s vector address 
Parent’s DH_V_ CHILD <-- child’s vector address 
Child’s DH__V_PARENT <-- parent’s vector address and Parent’s 
DH_V_ CHILD <-- child’s vector address 


—meemrerert et or er C) OOO COCO CO 


0 
0 
0 
0 
1 
1 
i 
I 
0 
0 
0 
0 
1 
1 
1 
i 


—mOOeK ROOK KOOR HK OO 





Where, 
E = ATR_ENTRY bit state 
I = ATR __ISR bit state 


Accessing Driver from an Application 
When an application needs to access a driver, the following sequence must take place: 


3 i.e 
; V SYSTEM (12H) 


MOV BP, driver’s vector address 


MOV AH, function code 
MOV AL, subfunction code 


3; any other data passed 
= ; in registers 
PUSH DS 3; Saves application’s DS 
CALL SYSCALL 
POP DS 
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Examples of EX-BIOS Drivers 


NOTE 


Since the HP interrupt number can change, all "int HP_- ENTRY" lines in 
the following examples should be replaced with "CALL SYSCALL" (this 
routine finds the current HP interrupt number). 


Cursor Pad Scancode To HP Mouse Driver 


The first example driver is called CPP2GID. This driver implements the V_CCPGID EX-BIOS driver. As 
such, it translates from cursor control pad keys into graphics input device data. 


The driver is installed into the HP_VECTOR_ TABLE. The SF_INIT subroutine of the driver asks for 
enough EX-BIOS RAM to store the driver header and describe record. The DH_V_ PARENT field of the 
V_CCPGID driver header is initialized to the installable HP Mouse driver, V_LHPMOUSE (this driver is 
shipped on a separate disc with all Vectra series of personal computers). The DOS driver portion calls 
SF_START of the EX-BIOS driver. SF_START initializes the DH_V_ PARENT field of the V_CCP 
driver header to V_CCPGID. Then the installable V_LHPMOUSE driver is called with the override 
function. 


The installable driver completes initialization by printing an initialization completed message and 
returning to DOS. 


Now when the keyboard driver calls V_CCP to process a cursor control pad key, V_CCP calls 
V_CCPGID. The F_ISR of V_CCPGID decodes which key was actually pressed. The driver converts the 
cursor movement keys (up, down, left, and right) into relative movement data. If the key pressed was an 
insert or delete key, it is reported as the left or right button respectively. The driver first changes the 
describe record and then reports either a button press or a button release. After the input data is given 
to installable V_LHPMOUSE, the data is available thru the INT 33H STD-BIOS driver. 


NOTE 


As mentioned before, the HP_ ENTRY interrupt number is defaulted at 
OO6FH - but this number can change. The following examples show 

HP _ ENTRY at its default, but when accessing EX-BIOS drivers you should 
use a "CALL SYSCALL" in place of "int HP_ENTRY.” 
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CCP__TO__GID__ FILTER 


. 286c 
page $8. 132 
title CCP TO GID FILTER installable driver 


-PeeDRIVER HEADER acme weewewcenesesacsasse sees eee ee eee es eee eesseeeesES 


ooo ooooooSo 


ooo coooocoo 
moo COOCCoOOO 


= OO6F 


0000 10 [ 


© © © © © © 68 09 09 68 00 OD OD 8 OO SI SEEN IE I ODADAMDAMDAMAUUUUN PAS NAN & & & & & & & & & B&O WO WW D&W AAD PO DD BP PO ee 0 OO WP 


WN OO BDNAVEWN& OO BNAN EWN OO DOUAURUN OO UE VRUNE OD OUNAUBUN + OD ONOAU EWN OOO YUHAUBUWNH OC UNAUBWNHEO 


WAME CCP_TO_GID_ FILTER Inetalled DRIVER 
DESCRIPTION. This is an EX-BIOS driver which converts cursor 
control poe cursor keys into GID. T_REL18. movements 
It ts a brother to the V_CCPCUR. V_CCPNUM. V_RAW. and 
V_OFF, filters of the V_CCP translator 
One cursor oe report generates one micky in the direction 
indicated by the cursor pad key In addition the cursor 
control pad <Ins> key is mapped to the Bl <o> mouse button 
and the cursor control pad <DEL> key is mapped to the B2 <oo> 
mouse button 
OPERATION 
This driver is installed through the MS-DOS installed device 
driver system with the command line: 
devicesCCP2GID EXE 
The driver links itself into the HP VECTOR TABLE and maps 
itself to be the parent driver of the V_CCP driver 
The driver then returns to DOS releasing the initialization 
code it no longer requires back to DOS 
PARAMETERS 
ON ENTRY in MS-DOS portion es bx points to 
eytton Request Header 
in HP portion ah contains function 
code, al usually contains 
the output character 
ON EXIT in MS-DOS portion status is returned in 
rt Aptis Request Header 
in HP portion ah contains the return 
status code 
REGISTERS ALTERED in MS-DOS portion none 


in HP portion ax. bx, di. bp 


HP_SHEADER 
DHTATR 

DH” NAME _ INDEX 
OH_V_OEFAULT 
DH_P~CLASS 
DH_C CLASS 
DH_V_PARENT 
DH_V~CHILD 
DH_MAJOR 
DH”MINOR 
HP_SHEADER 


HP_ENTRY 


SYSCALL 
ifnbd 


endif 


COMM OPeeaanad 
oo CCCOCCOO 
oo COON COO 

coocooooe 
ecooec]jc]o 


ATR_CSHARE 
ATR”-DEVCFG 
ATR_HP 
ATR_ISR 
ATR_LOG 
CL_tcP 
CLTLGIO 


DESCRIBE 


7? 


SOURCE 


HPHIL_ID 
DESC MASK 
“10_ MASK 
“XDESC_ MASK 
DO” MAX ARIS 
D_CLASS 


ie) 
10) 
O 
ie) 
D 


Vv LY 
Vv OY 


D_PROMPTS 


struc 
dw 0 
dw ) 
dw 0 
dw ) 
dw i) 
dw Co) 
dw 0 
db to) 
db 0 
ends 
equ O6FH 
macro vector 
<vector> 
mov bp .vector 
int HP_ENTRY 
endm 
equ 0008H 
equ 4000H 
equ 8000H 
equ 2000H 
equ 0600H 
equ 2000H 
equ 0020H 
STRUC 
db size HP_SHEADER dup (7} this data is always offset by 
db ? 7-4 (high nibble) contains the GID type 
3-0 {low nibble) is the address of the device 
db ? device id byte returned by an HPHIL device 
db ? describe header from HPHIL device 
db ? 1/0 descriptor byte from device 
db 4 extended describe byte from device 
dh ? Maximum number of axis reported 
db ? device class 
7-4 (high nibble) contains current class 
3-0 (low nibble) contain the default class 
db ? number of buttons/prompts 


7-4 
3-90 


(high nibble) is t 


e number of prompts 
{low nibble} 


is the number of buttons 
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95 0018 77? O RESERVED db ? . reserved for future 
98 0019 77 DO BURST _LEN db ? , Maximum burst length output to a device 
Q7 if devices supports more than 255 bytes then 
98 255 bytes is the default maximum 
99 OOLA 77? O_ WR REG db ? number of write regis ers tupported by a device 
100 001B 77 O -RO_REG db ? number of read rey aters sopee cine by a device 
101 00o1C 7? O TRANSITION db ? transitions reported per button 
162 0010 ?7 O STATE db ? current state of buttons 
103 QOOL1E 2777 O RESOLUTION dw ? . counts / cm (m) returned by HPHIL device 
104 0020 7777 O SIZE_x dw ? . Maximum count of in units of resolution 
10§ 0022 7777 DO SIZE Y dw ? 
108 0024 7777 OUaABS Xx dw ? data reported from device 
107 00286 777? D_ABS_Y dw ? that reports absolute data 
108 0028 7777 D REL Xx dw ? data reported from device 
109 OO2ZA 7777 D RELY dw ? that is relitive 
110 002C 7777 b ACCUM. Xx dw ? these are used to accumulate scaling 
ii OO2E 777? O_ACCUM_Y dw ? remainder 
it 0030 DESCRIBE ENOS 
tee * 0030 OESCRIBE SIZE @qu size DESCRIBE 
116 » OOLE o Gy STATE equ O_STATE + 1 
117 . D SIZE equ bo SIZE X 
118 . 9) SAMPLE ABSOLUTE equ el ae x 
119 . D SAMPLE RELATIVE equ D REL X 
120 “ D_ REMAINDER ACCUM equ D-ACCOM X 
12} “ O BUFFER equ OD SIZE X offset where buffer begins 
122 «= 0OFO D CLASS CURRENT equ OFOH 
123 = OOOF ODO CLASS DEFAULT equ OOFH 
124 The field LD SOURCE user the Tol ewane to access the defined nibbles 
125 = OOOF O ADDR MASK equ 
ie « OOFO D_ TYPE “MASK equ bron 
128 = OOOE F INS FIXGETOS equ OOOEH 
129 » 0004 F YO CONTROL equ 0008H 
130 * 0002 SF_MDUSE OVERRIDE equ 0002H 
131 « 0000 Ff YSR equ 0000H 
132 * 0002 F SYSTEM equ 0002H 
te * 0002 SF START equ 0002H 
13 
135  RKKKAAAAAKAAKKAKE ATK AKAK AKA AKA KKAKAKAKAKAAKEAKAKAAKKAAK RAK KKK AKKKE KE AAA KKKKAE 
136 ihe following structures are used to access MS-DOS driver command blocks 
137 , SEAR AKKKMAKAAKK KAMAGRA AK KAKA KKAKAKAEMRAKAKKAKAAKEKK KEK KAKA KKKKAAKE KALA KRAKKA AKA 
138 MSD HEADER macro ATT STRATEGY ENTRY, ISR_ENTRY, STRING 
139 dd “i :mark a& last driver in List 
140 dw ATT 
141 dw STRATEGY ENTRY 
162 dw ISR_ENTRY 
143 db STRING 
144 db 14 dup (7) Pad so it is paragraph aligned. 
oe endm 
14? MSD REQ HEADER atruc 00; structure for access to MS driver cmds 
148 0000 77 MSO CMDLEN ? (00, zona of cma in bytes including data @ end 
149 0001 77 MSO_UNIT db ? :01; unit number for command 
150 0002 7? MSO CMO db ? ,O2: command code 
181 0003 7777 MSD STATUS dw ? .03, filler with completion status before return 
ae 0008 08 [ oF db 8 dup (7) >; area reserved for DOS 
oF) 
154 ) 
158 
187 0000 77? MSO MEOIA db ? .13; most cmds have this defined in the data area 
158 OOOE 7777 MSO_ TRANS dw ? (214, 
159 0010 2777 dw ? 516, 
160 0012 7777 MSD _ COUNT dw ? :18, 
161 OO14 7777 MSO START dw ? 520, 
+e 0016 MSD REQ HEADER ends 
163 
164 MSO_INIY_CMO struc 
165 0000 oo [ db 13 dup 1?) ‘first cover header area 
166 2? 
187 } 
i6a 0000 ?? 
MSO_UNIT_COUNT db ? OB :number of units service by thia driver 
176 OOOE 777? MSO ENO OFFSET dw ? OC ,offset of end of code ” 
17h 0010 7777 MSD_END SEG dw ? OE :segment address of end of code 
HG IB mepere eee Se} 
27? MSD dw ? 14 .seg offset of BPB list for units attached 

174 0016 7? MSO_IST_ UNIT db ? 16 .telis driver letter of firet unit 
rs 0017 MSD _INIY_CMD ends 
17? « 0006 MSO _ INIT equ Q0000H 
178 » 0003 MSO _UNKNOWN CMD equ 0003H 
He 2 83 nab Ean sat Os 188680018 

. x 6qu 1000 used as upper byte in status wr 
ee = 0001 MSD _OONE STATUS equ 000000018 , bit issere bit Sedone ¢ 
183 ~ 0006 RS DONE equ O006H 
184 » 0000 RS SUCCESSFUL equ 0000H 
ie * 0002 RS UNSUPPORTED equ 0002H 
187 « 0009 Y KC_ BUTTON equ 0008H 
188 * 0041 T RELI6B equ O041H 
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189 
190 » 00086 V_DOLITTLE equ 0006H 
191 ® 00A2 V_CCPGID equ OO0A2H 
192 s 00CC V_LHPMOUSE equ OOCCH 
193 = 0012 V_SYSTEM equ 0012H 
nee = 004E V_ccP equ 004EH 
1 
196 = 0080 UP_DOWN BIT equ 100000008 ‘Key up or down 
197 = OOFF INIT BUT STATE equ OFFH -All off 
198 = 004C MSE NUM BUTTON equ 004CH ‘Offset of number of button in mouse RAM 
198 = 0030 CCPSGIO_ DESC SIZE equ 48 
ae = £608 CCP2GIO_HP_ATTR equ ATR_HP+ATR DEVCFG+ATR ISR+ATR LOG*ATR CSRARE 
202 [BURRS STAOMESTS TERE SASK STERRTTR ERT RRE ASR ESE RSS SSAeKSseseEeesuseeeeacne 
203 MS-DOS device drivers start at an offset of 0 rather than 100h. 
204 _ SSSOSSSRTSSTS RAS SSTSEERSTETSSSSSHESSCSSSC SASH Reese eeseeocesesaesensessesueeae 
205 CGROUP group CODE 
206 0000 CODE segment public ‘CODE’ 
207 assume cs CODE, ds NOTHING 
208 0000 one 0 
aon 0000 CCP2GIO_INSTALLED LABEL FAR 

1] SSP RR Be ees RBZ THSTK HAT SSTTER ESSERE ST eT ERSeeseseneenessessneeseesereer 
211 This is the start of MS-DOS driver portion of the code. It pretends 
212 to be a standard MS-DOS driver long aires HA to be loaded and 
213 initialized via CONFIG SYS After that this section of code will 
214 not be used {section 1) ; 
215 EROS SSSE RT SSTSSSHRSTTRTTRRRSSESSESSSS ER STARK ERSTE RHE ESHe ERA ese ese e TEE 
216 This 18 the MS-DOS device driver header. It must be the first thing 
217 in the code segment. Consult the HP Vectra MS-DOS Programmers Refer- 
218 ence Manual for more information BE SURE YOU DON'T RELEASE THE 
219 HEADER AREA AS AVAILABLE MEMORY, EVEN ON AN ERROR. THE SYSTEM WILL 
220 CRASH IF YOU DO. 
221 This is the only resident portion of the DOS driver, the rest 
222 of the DOS driver ia returned to DOS memory 
a , SSRMARAKRSSRSSCSSCRRSSH KK SKHSTERRSRERSESSASRKERRSSERHTRSSAR EES Heaeeaasevesan 

MSO_HEADER 08000h dev_strategy dev_int,.“ CCP2GID” device header 

225 0000 FF FF FF FF + dd -1 ‘mark as last driver in list 
226 0004 8000 + dw 08000h 
227 0006 O1AB R + dw dev_strategy 
228 0008 0106 R + dw dev_int 
229 000A 20 43 43 $0 32 47 + db " CUP2GID" 
Say 0012 OE [ + db 14 dup (7?) : Pad so it is paragraph aligned 
ee oe CCP2GID DRIVER Main entry point 
234 Reanim on noo Ora nO OO ISO IO GOGO OOD IOI 
235 . CS. Relative Data Area For Driver 
236 KKK RK KKK KKK KKK EK KKK KK KKK KKK KK KKK KKH KKK K KKH K KKK KAKA HHA KAKA 
237 0020 7777 gav_ bx: dw ? 
238 0022 7777 sav cx: dw ? 
239 0024 2777 gav_dx dw ? 
240 0026 77??? sav es: dw ? 
pe: 0028 7777 top_hp_entry: dw ? 
243 | RAKKKKK KKK AKA AA KKK AKA AAA AKA AK KAA KA KK KAKA KAKA AKK AKA AKAAAKAA KAKA AKAAK AAA KKK 
aie This is the EX-BIOS installed driver CCP2GID. 
246 ARK AKKKK KK A KKAAK A AKA HK KAKA AK KKH HK AK KKH KK AK AK AKAM AHH KKK KK KAKA AK RK KKK 
247 002A CCP2GIO DRIVER PROC FAR 
248 002A 80 FC 00 cmp ah. F_ISR :Is the function F_ISR? 
249 0020 74 0B je short CCP2GID_ISR 
250 OO2F 80 FC 02 cmp ah, F SYSTEM :Is the function F_SYSTEM? 
251 0032 75 03 jne CCP2GID_UNSUPPORTED 
252 0036 £€9 0100 R ime CCP2GID_SYSTEM 
253 0037 CCP2GID_UNSUPPORTED : 
254 0037 B4 02 mov ah RS _ UNSUPPORTED ‘This driver doesn't support 
See 0039 CF iret any other functions. 
eet 003A CCP2GID_ORIVER ENDP FAR 
259 subttl CCP2GID_isr function 


page 


,eaeDRIVER HEADER eeuesceecnevonasasesssnseesezeneasesseeeeeseeeses oases 
NAME : CCP2GID_ISR 


: DESCRIPTION: This function translates valid ISR event record into 

‘ mouse type movement or button reports, calls its parent driver 
; with an TSR Event Record and then returns to the calling 

' driver with a return status of RS_OONE 


PARAMETERS 


ON ENTRY: ISR Event Record of type ¥_KC_HP_CCP 
: BP = V_CCPGID 
; OS «= this drivers data segemnt 
: AH = 0 { F_ISR } 


NVNNNAVNNNN NNN NN NNN VND 
DOD 08 I dd IIB ROAR OOD 
IH OD OONRUEWN OD 8 jABUNWH-O 


CALL PARENT: ISR Event Record of type T_REL16 or T_KC_BUTTON 
T_RELIG: AH = 0 { F_ISR ) 
; BX = axis 0 value X axis or Col 


CX = axis 1 value Y axis or Row 
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T_KC_BUTTON 


ON EXIT 


REGISTERS ALTERED: 


OH « 


41H ( T_RELI6 ) 
® describe record of V_CCPGID 


DL = V_CCPGID/6 


AH = 0 ( F_ISR 

BL = 006H = 
OO1H - 
O80H - 
O81H - 

T_KC_BUTTON 

0 

e 

Vv 


this 
CCPGID/8 


omog 
rox x 


AH = RS DONE 
ax, bp and ds 


break Button 
break Button 
make Button 
make Button 


t 

2 
1 
2 


device describe record 


283 
284 
2858 
286 
287 
288 
280 
290 
291 
292 
293 
294 
295 
296 
297 
208 
209 
300 
301 
302 ; 
303 003A CCP2GIO_ISR 
304 
305 003A 50 
306 003B 2€. 89 1E 0020 8 
307 0040 2€: 88 OF 0022 R 
308 0045 2€: 89 16 0024 R 
nts OO4A 2E€ 8C 06 0026 R 
1 
311 OO4F 8C DA 
312 0051 8€ C2 
313 
314 0083 32 FF 
315 0055 83 FB 60 
316 0058 %74 221 
317 COOSA 83 FB 61 
318 005D 74 24 
319 OOSF 83 FB 82 
320 0062 74 27 
321 0064 83 FB 83 
322 0067 74 2A 
323 0069 80 £3 7F 
324 006C 83 FB 88 
325 OO6F 74 3E 
326 0071 83 FB 69 
327 0074 74 3€ 
328 0076 B4 06 
329 0078 EB 7B 90 
330 
331 0078 ccp_up. 
332 0078 BB 0000 
333 OO7E BO FFFS8 
334 0081 €B 18 
335 
336 0083 ccp_left: 
337 0083 8B FFF8 
338 00868 B69 0000 
339 0089 EB 10 
340 
341 0088 ccp_down: 
342 0088 8B 0000 
343 OO8E 89 0008 
348 0091 EB 08 
345 
346 0093 cep_right 
347 0093 BB 0008 
348 0098 689 0000 
349 0089 EB 00 
350 
351 0098 rel_move 
352 009B 89 1E 0028 
353 OO8F 89 OE 002A 
354 OOA3 O1 1E& 0024 
355 QOOA? 01 OF 0026 
356 OOAB B6 41 
357 OOAD EB IC 
358 
359 OOAF ccp_buth: 
360 OOAF BB 0000 
361 00B2 8 OS 
362 
363 0084 ecp_but2. 
364 00B4 68 0001 
365 00B7 €8 00 
368 
367 0OB9 but process 
368 00B9 B68 0001 
369 oOoBC 8A CB 
370 OOBE D2 £0 
371 00CO A2 001C 
372 
373 
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label 


push 
mov 
mov 
mov 
mov 


mov 
mov 


xor 
cmp 
je 
cmp 
je 
cmp 
je 
emp 
je 
and 
cmp 
ye 
cmp 
je 
mov 
Jmp 


mov 
mov 
ymp 


mov 
mov 


J™p 


mov 
mov 
jmp 


mov 
mov 
jmp 


mov 
mov 
add 
add 
mov 
jmp 


mov 
jmp 


mov 
jmp 


mov 
mov 
shl 
mov 


near 

ax 

word ptr cs. sav_bx.bx fave the keyboard's isr 
word ptr c&8 Sav_cx,Ccx 

word ptr cs: sav_dx,dx 

word ptr cs. sav_e8 es 

dx ids point to the mouse itr 

es dx 

bh.bh .translate the scancode to GID 
bx 60H check for cursor up 

short ccp up 

bx 61H -check for cursor left 

short ccp_left 

bx 62H ,check for cursor down 

short ccp_down 

bx 63H ,check for cursor right 
short ccp_right 

bl. O7FH 

bx 68H .check for INS or button 1 
short ccp_butl 

bx. 69H .check for DEL or button 2 
short ccp_but2 

ah RS DONE recieved an unsupported key 
exit Isr 

bx .0 fo movement on the X-axis 
cx, -8 ‘industry standard upward move 


short rel _move 


bx, -8 
cx,0 
short rel move 


bx 0 
cx,8 
short rel _move 


short rel_move 


:Megative move on the X-axis 
,No movement on the Y-axis 


No movement on the X-axis 
‘industry standard down move 


move right on the X-axis 
,no movement on the Y-axis 


ds D REL X.bx ,save new relative move (¥} 

ds 0 REL Y.cx ,@ave new relative move (Y 

ds D0 ABS X.bx ,tave new absolute position {¥} 
ds 0 ABS Y.cx .bave new absolute position (Y 
gh. T RELT6B 


short give _to parent 


bx .0 
short but process 


ox 1 
short but process 


ax ,0001H 
¢1,61 
al.cl 


byte ptr ds:D_ TRANSITION, al 


button one got pushed 


:button two got pushed 


get the proper bit set in D_STATE 


‘record in the describe record 
which button changed 
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PPaSRWWWWOYW WWW WWWWWW WWW WWW WW WW) 
SOOO SO HOO OCOD © © @ © & 00 © 00 0 & OO @.00 CO ~~) I I 
PWN OD ONAN Wr OW 8 NOU BWM O11 CUO 


eo eee oe oe 


GID © G09 C9 £9 09 CI RD PDD PID PO PO FD RP Be eh OO 
CCOBNAN EWN OO DOYDN AWA OM DOHUAUAUAE- OMS 


Pho &FL HLS HLRDSLLaaARraALFDaADDaA 


> 


00C3 2€. 8B OE 0020 R mov cx,word ptr cs :sav bx get the scan code and check for 
00c8 *F6 Cl 80 test cl, UP_DOWN BIT “push or release 
OOCB 74 08 jz but_push 
o0cd but _releate: 
00CD 08 08 0010 or ds D_STATE,al show the release in D_STATE. by 
00Di EB 08 jmp short putton_done Setting the bit 
0003 but push 
0003 =F 0 not al show the push in D_STATE by 
00D5 20 086 0010 and de:D_STATE ai Clearing the bit 
0008 &EB 00 ymp short button_done 
0008 button done 
00ODB 2E€ Al 0020 R mov ax.word ptrocs sav_bx ‘was button pushed or released? 
OODF 24 80 and al,.080H . : 
OOE1 OA DB or bl.al -record in bx 
OOE3 32 FF xor bh bh 
OOES 33 C9 xor cx cx 
OOE7 B86 09 mov ah.T KC BUTTON 
OOES £8 00 jmp shorf give to _parent 
O0EB give _to_parent: 
OOEB B4 00 mov ah. F_ISR Execute ISR of parent 
OOED 82 18 mov d1,V_CCPGID/6 source vector is this driver 
OOEF 8B 2E 000A mee op.ds.DH_V_PARENT Get my parent's vector from my header 
YSCALL 
OOF3 CD 6F + int HP_ENTRY 
OOFS exit_isr: ; 
OOFS 2E: 8B 1E 0020 R mov bx word ptr cs: sav_bx -restora to keyboard ISR state 
OOFA 2E: 8B OE 0022 R mov cx,word ptrcs sav cx 
OOFF 2E: 8B 16 0024 R mov dx word ptr cs sav_dx 
0104 2E 8£& 06 0026 R mov es word ptr cs sav_es 
0109 58 pop ax 
OL10A Ba 06 mov ah. RS DONE ‘Record on return 
O10C CF lret 
aubtt] CCP2GID_ system function 
-mesDRIVER HEADERessaccenreracreereen seer eee e BERR Oe 
NAME CCP2GID system function 
DESCRIPTION: Decodes the appropriate syatom function 
Supported Subfunctions aro SF_INIT 
SF START 
SF REPORT STATE 
SF VERSION DESC 
PARAMETERS 
ON ENTRY 
ON EXIT 
Z | REGISTERS ALTERED ax, bx. di. bp 
SSeS Sees ence ve nee beneuas ea weccssctabecitesendancssdwwas'wanentdawsaedeed 
0100 CCP2GID_SYSTEM labdel near 
0100 3C 06 90 $0 cmp al.MAX CCP2GID_ SYS _FN .Is the system subfunction 
Ol11 77 00 ja short CCP2GID bad sys_fn “within the valid range? 
0113 87 EB xh bp.b Load th 
0115 BA DB bead be el eats ie jump table index 
0117) 32 FF xor bh bh 
0119 87 EB xehg bp.bx 
0118 2E: FF AB 0123 R jmp cs word ptr CCP2GID_sys_case(bp] | 
biee ee CCP2GID_bad sys fn 
h RS UNSUPPORTE R 
0122 CF pene a ms D eturn status as unsupported 
CCP2GID_ system subfunction jumptable 
0123 CCP2QGID_ ays case 
0123 O12B8 R dw word ptr CCP2QI0_sys_init -SF_INIT 
0125 O147 R dw word ptr CCP2GIO sys start SF _USTART 
0127 0120 R dw word ptr CCP2GIO bad sys _fn .SF REPORT STATE 
0128 0120 R dw word ptr CCP2GID_bad_ sys fn .SF_VERSION_DESC 
= 0006 MAX CCP2GID_SYS FN equ byte ptr {$ - CCP2GID_sys case - 2) ~ 
subttl CCP2GID system function - init subfunction 


,eeeDRIVER HEADER ss cecsununccaeeenaeserrenecen ee seeseaeee ease es aoe e Eee 


NAME : CCP2GID_ system function - 


DESCRIPTION: 


Initializes Describe Record and Exits, 
os 


init subfunction 


allocating a 


Driver Writer’s Guide F-25 


CCP__TO__GID__FILTER 


466 


a 
oa 
~ 


PARAMETERS 


ON ENTRY: ah «= F_ SYSTEM 
al = SF_INIT 
bp = V CCPGID 
bx = last used data segment 


ON EXIT: ah « RS SUCCESSFUL 
bx = last used data segment - this drivers data segment 


mh ba heabh 
SNS NS NSN SIO oD 
ANS WN OW cs 


4 

ne REGISTERS ALTERED: ah, bp, and ds 

479 ; SM PSS SSH SSSA ESET STE SSS SHREK ESS KSSETAPEHHHKRE ESAT BBA Re EHR BES EEE 
480 : 

431 0128 CCP2GIO_sys_init lebel near 

482 012B 06 push es wf 

483 012C 56 push si 

484 0120 $7 push di 

485 012E— §1 push cx 

486 OlcF 83 EB 03 sub ox, (CCP2GID DESC _SIZE+15)/16 

487 0132 8€& C3 mov es. bx 

488 0134 BE O177 R mov si.,offset cs CCP2GID desc headr 

489 0137 FC eld 7 

460 0138 33 FF xor didi 
491 013A BS 0030 mov cx,CCP2GID_ DESC SIZE 

492 0130 F3/ 2€: Aa rep movs byte ptr es: (di}.cs:(si) 

493 0140 5§9 pop cx 

494 0141 SF pop di 
495 0142 «SE pop si 
ih SHE yt 

4 00 mov R 

498 Ode CF RON. ah. RS SUCCESSFUL 
499 

500 page 

ae PesORIVER HEADERsecsunenesresnemne serena sere ESR Re Ree eee eee 
283 NAME CCP2GID_system function - start subfunction 

505 DESCRIPTION: Relinks the V_CCP driver to this driver, V_CCPGID, 

$06 to this driver is activated to translate cursor control 
ae pad reports to mouse type movements 

08 

$09 

a PARAMETERS 

$12 ON ENTRY AH » F_ SYSTEM 

§13 AL © SF_START 

§14 BP = V_ CCPGID 

515 

516 

ce ON EXIT AH « RS SUCCESSFUL 

ae REGISTERS ALTERED ah, ds. bp 

§21 WITTIITIIT IIT TTT rer Teer eee eee ee rere rrr reer er 
S22 

$23 

524 0147 CCP2GID_sys_ start label near 

525 0147 «$0 pus ax 

526 0148 1E push ds Save the ds register 

§27 0149 B8 0000 mov ax,0 Set the ds to the Int vector 
528 014C 8E 08 mov ds ax 

528 OL14E Al OBE mov ax,ds ((4 ® 6FH) + 2) Get the HP_VECTOR TABLE segment 
530 0151 2€ AI 0028 R mov word ptr cs top _hp_entry,ax 

$3. 0155 8E D8 mov ds ax 

532 0157 Al 0052 mov ax.ds (V_CCP+4)} Get the top of the header for the 
533 O1SA 8E DB mov ds.ax .V_CCP driver 

534 O15C C7 06 000A 00A2 mov ds (DH tees Peoria Have V_CCP point to me 
$35 0162 2E€ Al 0028 R mov ax.word ptr cs fop_hp_entry load ds with HP_VECTOR_ TABLE segment 
536 0166: 8E O8 mov ds.ax 

$37 0168 Al 00DO0 mov ax.ds. [V_LHPMOUSE +4) Point to the top of RAM for the mouse driver 
538 0168 8E D8 mov ds ax 

$39 0160 C8 06 004C 02 mov byte ptr ds:MSE NUM BUTTON ,2 Define the number of buttons to 2. 
540 0172 oF pop da ‘Restore the ds 

$41 0173 58 pop ax 

$42 0174 B4 00 mov ah, RS SUCCESSFUL 

oa 0176 CF fret 

$4 

$45 subttl DOS-Install Code ( Returned to DOS ) 

546 age : 

$47 0177 RET RN_THE FOLLOWING RAM_TO_DOS label far 

548 temporary EX-BIOS Header configuration template 

$49 * 

550 0177 E608 CCP2GID_desc headr HP_SHEADER <CCP2GID_HP_ATTYR.V_CCPGID/6,V_CCPGID ,CL_CCP CL_LGIO 

.V_LHPMOUSE ,V_OULITTCE> 

$51 0179 0018 

552 0178 Q0A2 

$$3 017D 2000 

554 O17F 0020 

555 O18: 00CC 

556 0183 0006 

557 0185 00 

558 6186 00 
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559 

560 0187 

561 O187 OF 

562 0188 00 

563 0189 00 

564 018A 00 

565 0188 00 

5686 O18sc «02 

$67 0180 00 

568 O18E 20 

$80 O18F 00 

$70 0190 00 

$71 019i 00 

$72 0192 00 

$73 0193 01 

$74 0194 FF 

575 Oi9S 0o0c8 
576 0197 0000 
$77 0199 0000 
578 019B 0000 
579 0190 0000 
380 O18F 0000 
$81 O1A1 0000 
582 01A3 0000 
583 O1A5 0000 
$44 

§35 

$86 

$387 

5388 

$89 O1A7 = 7777 
590 OLAS = 7777 
$91 

592 

$93 

$94 

595 O1AB 

596 

597 O1AB. 2E: 89 1E O1A7 R 
Sos 0180 2E: 8C 06 O1A9 R 
399 0185 CB 

600 0186 

601 

602 

603 

604 

605 

608 01B8 

807 

608 O1B6 0286 R 
609 O1B8 0213 R 
610 OLBA 0213 R 
611 O1BC 0213 8 
612 O1BE 0213 R 
613 01CO «0213 Rk 
614 O1C2 0213 R 
615 O1C4 0213 R 
616 01C6 0213 R 
817 01C8 0213 R 
618 O1CA 0213 R 
819 01CC 40213 R 
620 O1CE 0213 8 
621 0100 0213 R 
622 0102 0213 R 
623 0104 0213 R 
624 

625 

626 0106 

627 

628 0106 9c 

629 0107) «FC 

630 0108 60 

631 0109 1€ 

632 O1DA 06 

633 

634 OL10B O€ 

635 o10C «oF 

638 

637 0100 C4 36 O1A7 R 
638 OLEL 26: 8A SC 02 
6390 O1ES 80 FB 00 
640 O1E8 72 11 
641 O1EA 80 FB OF 
642 OLED «77 «0C 
643 

644 

645 

646 OLEF 32 FF 
647 O1FLl O1 €3 
648 O1F3) 2&: FF 97 0186 R 
$38 O1F8 EB 10 90 


LTER 


CCP2GID_desc 


db OFH .D_SOURCE 

db 0 .DO_HPHIL IO 
db 0 .0_DESC_RASK 
db 0 ,0_I0. MASK 

db 0 .O_XOESC_ MASK 
db 2 .O_MASK_AXIS 
db 0 .O-CLASS 

db 020h :0. PROMPTS 

db 0 -D_RESERVED 
db 0 -O BURST LEN 
db to) ,O_WR REG 

db t) -O_RD_REG 

db 1 .DO_ TRANSITION 
db INIT_BUY_STATE (DO 7STATE 

dw 200 .D RESOLUTION 
dw r) -O SIZE X 

dw te) O SIZE Y 

dw 0 -DTABS X 

dw 0 .0_ABS_Y 

dw 0 D-REL_X 

dw 0 .D RELY 

Ow 0 .0_ACCUM_X 

dw 0 ,0_ACCUM_Y 


This completes the MS-DOS device driver section 
and begins the HP device driver code (section 2) 


rh_off dw ? :request header pointer offset 
rh_seg dw ? :request header pointer segment 


device reese gy (required by MS-DOS 3.1) 
save es Gx (address of request header) and return 


dev_strategy PROC FAR 


mov ca rh_off bx fave offset of request header ptr 
pad ce rh_seg.es :Bave segment of request header ptr 
re 


dev_atrategy ENDP FAR 


device interrupt bregers ts oy MS-00S 3 1) 
use the command from the request header block as an index 
into the table of command processing routines 


command table label word 





dw init initialization 
dw media check ‘media check Weiser eer 
dw build dpb .build bpb block only 
dw foctl_ in .foctl input 
dw input input (read) 
dw nd input Mon-destruct read char only) 
dw in_stat input status char only} 
dw in_fiush input buffer flush char only) 
dw output -output oe) 
dw out verify :output (write) with verify 
dw out stat Output status char only 
dw out flush eeelw buffer flush (char only 
dw soctl out ,loctl] output 
dw dev_open device open 
dw dev close :device close 
dw rem_media .removable media 
, SR SSSS Sewanee neBssseesesasssecssaansseneesseeenavesesseeEeeaseeeseaens 
dev_int PROC FAR 
PR SSMS SH OSR ATA STESASLSRHSSERHSHE SESS HAAT RSH EESeSeeHHesesestesansees 
pushnf 
eld preserve machine state 
puta 
push ds 
posh es 
; OS is CS 
push cs 
pop ds 
les si,dword ptr ds [(rh_off) loads es a3 
mov bles C42} MSD_cMD get function byte 
cmp bil. .MSO_INIT Quit if lower than 
jb bad cmd : lowest command number 
cmp b1,MSO_REM MEDIA Quit if higher than 
ja bad_ cmd , Nighest command number 


command is valid; go do it 


xor bh. bh 

shl bull Make BX offset into table 
call word ptr cs:command tadle(bx) 

Jmp int_exit 
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bad cmd 
les 
mov 
mov 
mov 
Jmp 


all finished 


36 O1A7 R 
03 


8} 
88 44 03 
01 90 


OoocVdc0s 
NMR eH eee 
oooun7s” 
Nive 1D 
MmNOMo 
DRaO m 


int_exit 
les 
pop 
pop 
popa 
popf 


1€ O1A7 R 


ooo0oocoo0°o 
PIRI RI API ROPRIAD 
eee OOCO 
Wt O NMP 
O@O@er-on 
OO we 


dev int 


unsupported 


modia check 
build bpb: 
roctl_in 
input: 
nd input 
in_atat: 
in_fluah: 
output. 
out_verify: 
out stat: 
out flush: 
focTl out: 
dev_ open: 
dev_close. 
rem_ media: 
all_ok: 
xor 
mov 
les 
mov 
ret 
unsupported 


ON OWwW 

won 

ao@er-o 
o 


OAD APY I WII OI WLI I uw 
Wa Co me mn 


ecooocoocooe CeoooeooeoocooOoOOoOooO Ff 
PIRI PI AD POF PIRI PI PRIPIAIPI HS POTIAI PIPPI OD 
PD ee ee ee ee em ete ee 


page 
init - 


0220 init mag 


0242 init meg2 


0263 init _msg3 


OMAR EO FBRMVAU YASUE 
UN Lar PAS 08 0 ® & MP 00D HFT OO 
AWWA WOAYHAUOABe wav 
PUaWNOP - &OnNOODMVN aw WO 
CHOYVEVNABWANMOW WAN 
Ove eovecoeavc rrcawo 
OCeA*MaAanh BBVQGDALANVESBHaAa 
PUN awW ON BWEeOe>aw 
NSB & Caen War na 
PUIMOOW AMOOW VNOOW 

PIBMAM AV BSOvwr VMAwuw 

BONSS BONLOD MWOWO 


0286 
0288 


init PROC 


ela 
Put 


R les 
R lea 
OE mov 

mov 
10 mov 


oocoo 
NRRNAD 
ODOM 
Ww "wo~ 
NOAA wd 
aO0OeVva 


push 
pop 


install (init 


oo 
ne 
oe 
reo 


o£ 
O00A2 
JE OO2A R 


mov 
mov 
lea 


NE NE Bd i Ne tt hs St SS EES BBPAAADAGAAMNMAAMAW’HLAVDVNA]ABPADAVBAWIVA*VIANAARWAMAVNMMsVAVIOFDAADS®s 


Be Be Be BIG O90) 60 0) 0) 0 9 LO DS PIATRA AI PRO IDB RD be be OO ODO ODOC OOD OO OO OC OD © © OF OF O GO OD OF O8 00 OD Md SEE SI RDA ADADMA HS MNMNUMMAM HAAN 
WN eH OD ON DWMEOAN?- OD HDA AWN OD OW HUAN AUDA+- OO SBwOHF HUN OO BHAV BWA OD © HOUR WN OD 08 SOU & L392 OD OO HBU BUI OD © VOU SUA 


ooo 
NHN 
roo 
oom 
Yd 
bed 
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unknown command routine 


si.dword ptr ds (rh_off} ,reload es si w/ header addr 


al.MSO_UNKNOWN_CMD 
ah.MSO_ERR_ STATUS 

es ty MSD STATUS ax 
int_exit 


,8tatue word now in AX 
place in request header 


bu. dword ptr ds [rh_off) 
es 
ds 


-Teload os bx w/ header addr 


restore all preserved registers 


ENOP FAR 


' ALL MS-DOS functions except 


init are unsupported and do nothing 


PROC NEAR 


al,al 

ah, MSD_DONE STATUS 

si, dword ete ds (rh_off) 
es. {ti} MSO_STATUS ax 


ENOP NEAR 


:0 indicates OK 


reload es:si w/ header addr 
:return ok status 


setup variables & establish link in HP_VECTOR TABLE 


db “HP CCP2GID installed driver 2 2" OdH, Oak, “$" 
db “HP CCP2GID installation failed” OdH,Oah,"$”" 
db "HP CCP2GID installation suceeded” OdH Oa. "$s" 


NEAR 


next available memory location in System Request Header 


ai .dword ae ds (rh Poud :es:si .© header addr 
ax.cs. RETURN THE FOCLOWING RAM TO_DOS -put next free loc 
es word ptr [si]. MSD_END_ OFFSET. ax address in header 


ax,ca 
es ‘word ptr {si} MSD_END SEG, ax 


Put the driver into the HP VECTOR TABLE 


cs 

es 

} V_ccPaip 

an, F_LINS FIXGETDS  . Puts the driver in HP VECTOR TABLE 
bx. VICCPUID and calls to do F_SYSTEM*SF YNIT 
di. CUP2GID ORIVER - 


CCcP__TO__GID__FILTER 


744 O2A4 1€ 
745 
746 O2A8 BO 0012 
747 O2A8 CO 6F 
748 O2AA IF 
749 
750 O2AB B4 02 
751 02A0 BO 02 
782 O2AF IE 
753 
754 0280 BO 00A2 
755 02B3 CD 6F 
7586 0285 iF 
7$7 
758 02B8 B4 04 
759 02B8 BO 02 
760 
761 O02BA 80 O00CcCc 
762 0286 CO 6F 
763 O2BF JE 
764 02C0. O€ 
765 o2ci IF 
766 
767 02C2 860 16 0220 
768 02C8 B4 09 
769 02c8 CO 21 
770 O2CA IF 
771 O2cB FB 
772 02CC ES O213 R 
773 o2cr C3 
774 0200 
775 
778 0200 
777 
Macros. 
Name 
MSO_WEADER 
SYSTALL 
Structures and records: 
Name 
OE SCRIBE 
D_SOURCE 
O_HPHIL 10 
D-DESC_MASK 
O-10_MASK 
D_XDESC_MASK 
D-MAX_AXIS 
O-CLASS 
O_ PROMPTS 
O_RESERVED . 
O_BURST_LEN 
O-WR REG 
O_RO_ REG : 
O_ TRANSITION 
O_STATE . 
O_RESOLUTION 
O_SIZE_X 
O_SIZé_Y¥ 
o-aBs_X 
0 ABs Y 
O_REL_X 
O-REL Y 
O~ACCUM_Xx. 
0_ACCUM_Y 
HP_SHEADER 
DyH_ATR 


DH_NAME_ INDEX. 
OH”V_OEFAULT 
OH_PTCLASS | 
DH-C_CLASS 
OH~V~ PARENT. 
DH_V~CHILD 
DH-MAJOR 
DH-MINOR 
MSO_INIT CMD. 
MSD_UNYT_COUNT 
MSO"ENO_OFFSET 


30 _CMDLEN 
MSD_UNIT . 


++ 


push ds 

syscall V_SYSTEM 
mov pee SYSTEM 
int HP_ENTRY 

bok ds 

start V_CCPGID 

mov ah, F_SYSTEM 

mov al, SF_START 

push ds 

syscall V CCPGIO 
mov bp... CCPGID 
int HP_ERTRY 


t) 
inetatt fie Mou 
mov 
mov 

syscall 


push 
push 


pop 
; write a messag 


lea 
mov 
int 
pop 
ta 
m 
ret 

init ENOP 

CODE ends 
end 

Length 

0006 

0002 

Width @ fields 

Shift Width 

0030 0018 

0010 

0011 

0012 

0013 

0014 

0015 

0016 

0017 

0018 

0019 

OO1A 

0018 

00:1C 

0010 

OOLE 

0020 

0022 

0024 

0026 

0028 

002A 

002Cc 

OO02E 

0010 0009 

0000 

0002 

0004 

0006 

0008 

OOOA 

000C 

OO00E 

OOOF 

0017 0007 

0000 

OOOE 

0010 

0012 

0014 

0016 . 

0018 000A 

0000 

6001 


ds 

se Driver whether there is an HP Mouse or not 
ah. F_I10 CONTROL 

al. SF MOUSE OVERRIDE 


V_LHPROUSE 
mov bey. LHPMOUSE 
int HP_ENTRY 

ds 

cs 

ds 


@ on display saying driver installed 
dx, init _meg 


ah, 9 
21H 
ds 


all_ok (all linked so all finished 
NEAR 


Matk Initial 
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MSD_CMD 
MSD STATUS 
MSD “MEDIA. 
MSD “TRANS 
MSD “COUNT 
MSD START 


Segments and Groups 
Name 


CGROUP 
CODE 


Symbols 


Name 


BUILD BPA 
BUTTON DONE 
BUT PROCESS 
BUT PUSH 
BUT _RELEASE 


CCP2GID 
CCP2 
CCP 
ccP 
cce 


“BAD_SYS_FN 
esc 
ESC _HEAOR 


n 
<O 
baal 
zBui 

“ 

~ 

rm 
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TTR. 
LLED 


+ x4> 


BWNHOM YS 
VHEZYPE 


O00 
NOD 
vu 

RMA NNR 
OPHM 


ms) 
“D 
a) 

D 
H 
oy 
eae 
SS 

s 
_§ 
'§ 

U 


Z«K<<<xNZv0BM 
AWMNNWAY 
a 

BRAM 

44 

m 

7 


OnE +AHOOOCCVIVTTCCNN0N 


PE OC CO tae re et bee 
mare 
my 


oO 
oO 
wn CU wv 
6F-a : 
DONO HOVPOOCSEO- CBWMODODDOODOOOOOOHO 


444 OF HAMpDPHNU NWRavy FTTH T- OT 
~ 
“aYr 
-@ 


mm MMMOr CH OD 
pe<ccc 
a~ 
77 zr= mee 
ehese> -2 + ~m 
DO nw BEMmCc+wa om 
Nn 
mm 


CHCorHNNUM BM AOWUSD 
za. 


monn wm xo 


ome 
x 


om Pend 


PARENT 


4 YR FR VUNTTTY Yon 
zoom ONE 


< ZF LZeewD 


ad. nt 
Ort rates CU HNNNBOOODW 
a 
Los 
~ 
w 
~ 
> 
4 
m 


ame rerenaneeerere rere TOMIMNHAMOTOOCCVVTVVVTSD GQUTUNNN0NN 
HANMNM CHAAR HAMM<NOZHKH POM KOC 


OCzZZZTZZZZAv-<«- 


om: 


N 
“OUT ba 
MAX CCP2GID_SYS_FN 
MEDTA CHECK ; 
MSD DONE STATUS 
MSD ERR STATUS 

MSD INIT 

MSD REM MEDIA. 
MSD _UNKNOWN CMD 
MSE "NUM BUTTON 

ND INPUT : 
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Type 


L NEAR 
Number 
Number 
Number 
Number 
Number 
NEAR 
NEAR 


NEAR 
NEAR 


ah ak a ae sek eal co oak cae 


< 


COOCONBOOcon id 
c 


OVvDBOrernNSCcCcVCOr _ 


OPOwmPorsrsOOuo@mwuDoococrwy» 


COG CHEN HNOFDODOCOCOOr e+ DOMDOR EH 
PPOTNH HOP! OF} VBNOVODBDDPVENNOWOONW WOON 


MMOnXHMMO NOM HD QAWORBOOBWWDS AnNADBW 


i 


{ 


ODVVSSCOTOSOSO BDODDONDOSCOCHOSASCOSOSCOMBDOOCOOOCOOCOONBaROO 


AMOCSCO ANNs 


COVDTVDDCCCSCDCAOCCOOCCCCOSCOOOCOCOCOCOCDW 
NODCDOCONONNNNNYNNNNONDCOVOCOOOCS | 


WCW) HAO WOW WUWIW PWWNHO TNE ABNO & 


— ROCCO BOH ORR ee OF Aan Noe 


Combine Class 


PUBLIC CODE’ 


Attr 
CODE 


CODE Length #0010 


CODE Length #0030 
CODE Length #0008 


CODE Length s004A 


CODE 
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OUTPUT . L NEAR 0213 CODE 
OUT_ FLUSH. L NEAR 0213 CODE 
OUT_STAT L NEAR 0213 CODE 
OUT_VERIFY L NEAR 0213 CODE 
BEL MOVE L NEAR 0098 CODE 
REM MEDIA L NEAR 0213 CODE 
RETURN THE _FOLLOWING_ RAM_ to bos. L FAR 0177 CODE 
RH_OFF L WORD O1A7 CODE 
RH SEG L WORD 0O1A8 COOE 
RS DONE Ot he FS fon de ee oe Number 0006 
RS SUCCESSFUL... ae ne Number 0000 
RS UNSUPPORTED . & ty % . Number 0002 
SAV_BX dete Re ta Poe ey a) ae L NEAR 0020 CODE 
SAV_CX » 3 . Ansa R, ob tare L NEAR 0022 CODE 
SAV_DX .. wid Bat ade fe L NEAR 0024 CODE 
SAVES... Be tite bk a L NEAR 0026 CODE 
SF MOUSE OVERRIDE. : oe hee 2 Number 0002 
SF START : : . Number 0002 
TOP_HP_ENTRY 9 oe’ he ec sis 5 ow L NEAR 0028 CODE 
- Kt Boy yan a : : Number 0009 

“RELI6 i : . : Number 0041 
UNSUPPORTED : Sod ‘aps N PROC 0213 CODE Length #0000 
UP_DOWN BIT 4 tae oO ; Number 0080 
v_tce : a Number 004E 
V_CCPGID » & : ; : Number 00A2 
V_DOLITTLE : aye fers Number 0008 
V_LHPMOUSE ; : a Number 00CC 
V_SYSTEM £8 0 is, hook . Number 0012 

43048 Bytes free 

Warning Severe 

Errors Errors 

0 
ALL_OK 691% 772 
ATR_CSHARE 698 200 
ATR _DEVCFG 708 200 
ATR_HP 718 200 
ATR_ISR 728 200 
ATR_LOG. 738 200 
BAD_C 640 642 653% 
BUILD BPB 610 6778 
BUTTON DONE 380 385 387@ 
BUT_ PROCESS 361 365 3678 
BUT PUSH 376 382¢ 
BUTTRELEASE 3788 
CCP2GID_BAD_SYS_FN 435 4448 483 454 
CCP2GID_ DEST 5608 
CCP2GID DESC_HEADR 488 5508 
CCP2GID_ DESC SIZE 1998 486 491 
CCP2GID_DRIVER 2478 257 743 
CCP2GID_HP_ATTR. 2008 550 
CCP2GIO_INSTALLED 2094 
CCP2GIO ISR... 249 3038 
CCP2GID_SYSTEM 252 4326 
CCP2GID_SYS_ CASE 442 4508 455 
CCP2GIO_ SYS_INIT 451 4818 
CCP2GID SYS START. . 452 5248 
CCP2GID_UNSUPPORTED. 251 2538 
ccp_BuTl...... 325 3598 
CCP BUT2 327 3638 
CCP_DOWN 320 3414 
CCP_LEFT 318 3368 
CCP_RIGHT 322 3468 
ccPp_ uP 316 3318 
carOuP 205 
CL_CCP 748 550 
CL_LGIO 758 $50 
cove... .._.. 205 2068 208 207 778 
COMMAND_ TABLE . 6068 648 
OESCRIBE _. 77@ 112 114 
Deere be SIZE. 1148 
DEV OSE. 622 6898 
Oey NT 228 6268 669 
V_OPEN 621 6888 
BEV- STRATEGY 227 5958 600 
DH ATR ; 49% 
CC LASS 538 

BH -MAIOR ; 569 
OH_MINOR . S7¢ 
DH_NAME_ INDEX. 508 
OH_P_CLASS . . $26 
OH_V_CHILO . 55¢@ 
OH_V_DEFAULT $16 
OH_V er AER: $4a 399 $34 
O_AeSs_x. 1068 118 354 
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START 
SYSCALL 


SAV_CX 


SF MOUSE_OVERRIDE 


SAV_ES 
TOP_HP_ ENTRY 
T_kC_ BUTTON. 
TRET16. 


SAV_B8X 
SAV_OX 


SF 


UNSUPPORTED 
if 


UP_DOWN:8 


= 
wm 
os 
N 
bf 
~ 
oOo 
wr 
w 
oO -+t 
ww © 
oe 
zs oO 
oOo wm 
mo 


158 Symbols 


54092 Bytes Free 
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Application Resident EX-BIOS Driver 


This example demonstrates the use of an application resident EX-BIOS driver. The driver utilizes the 
Touchscreen logical device driver V_LTOUCH and its associated event driver V_EVENT_TOUCH. 


The driver utilizes V_LTOUCH to move the cursor around the screen. V_LTOUCH returns the current 
row and column address of the point at which the screen is being touched. The example driver in turn 
utilizes the STD-BIOS Video driver (INT 10H) to change to the position of the displayed cursor to match 
the screen coordinates returned by V_LTOUCH. 


This driver also utilizes the button state data returned by V_LTOUCH. When the screen is touched (a 
button make) the driver changes the shape of the cursor from an underline to a box or full character 
cell. The shape of the cursor is restored to an underline when the finger is removed (a button break). 


Notice in the initialization section of the code that the CS:IP of the driver’s service routine . 
(TOUCH_HANDLER) and the driver’s DS are substituted into the V_EVENT_ TOUCH vector in the 
HP__VECTOR_TABLE. The existing contents of that vector are returned by the function. The driver 
stores these values in its data area and restores them when the driver terminates (a " character is typed at 
the keyboard). All HP_VECTOR_ TABLE vectors that are replaced with application program resident 
drivers should restore the original values in the vector when the application program terminates. 


The listing for this driver can be found in Chapter 4. 


Non-HP-HIL Input Devices 


The next program listing is an example of how to integrate non-HP-HIL input devices into the Input 
System. This driver interfaces to an RS-232 mouse. It converts data frames received from the mouse into 
GID motion and button ISR Event Records. It integrates itself into the Input System by calling the 
V_SINPUT driver once these ISR Event Records have been constructed. 


The PGID driver is the physical device driver for all devices inputting graphic motion and button state 
data. The initialization code must create a PGID driver for the V_SINPUT to pass the ISR Event Record. 
It builds a driver header and physical describe record, allocates a free HP_VECTOR_ TABLE vector, and 
installs the PGID driver with V_LHPMOUSE as its parent driver. 


The driver is structured as a DOS installable device driver. The COM port the mouse is connected to can 
be specified in the CONFIG.SYS command line. 
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RS-232 Mouse Driver 


86c 

F COND 

GE 59,132 

TLE RS-232 MOUSE ORIVER 

BIYL PREFACE 
RRARARRRARAARRARAARARARARAHAAARAARRARAKRAEARARARAARARAREKRAHRRARRARAAARRPRRAKRKRARAKRHR ARE 


RS-232 MOUSE ORIVER EXAMPLE . 


RAARAARARHRARRARARARAARRARRARAARARARARAARARARAAARARRARARKRARRHERRAHRAKRHRARHARKRARRAKRARA 


ARARRAAARAARARARAARRAARARARARAAAARKREARAHRARRARARARAARRARARARHRARERARAAARARAARAABA 


2s DESCRIPTION . 


ARAAAAARARARRAAAAAAERARHARARRARRRAARARARAKRERARARARARAARARAARARRERHAKRARHR ARE 


This driver illustrates the integration of non-HP-HIL devices into the 
HP Vectra Input System This driver supports any mouse with an RS-232 
interface, such as the MOUSE SYSTEMS mouse The driver is installed as 
an MS-OOS device driver at boot time 


.The command line DEVICESEXAMPLE SYS (/0) should be entered in the 

CONFIG SYS file in the root directory of the boot drive Tf the optional 
.COM port number. /n is not included in the command line. the driver will 
,attempt to install the mouse on COM) If the optional COM port number 18 
present in the command line, the oriver will attempt to install the mouse 

on that COM port number The driver checks to make sure the port is present 
,and will issue an error message if a non-existent port number is specified 


’ 
- RARAAARAARRARAAHRARARAAAARARARAARARATRARKAARE RAK HRA RARKRAKRHARRARARARARHARARAA 


‘ CHANGE LOG = 


’ 
RAERAAARARRKAAAAAAARAAARARARARAKRARARARARRRARAARRARRARAAARRARRKRARARRARARAKRARRAD 


“Revision A OL OL - 12/02/85 SMM 


AARRARAARARARARARARARARKRARAARAARARARARARARARRARARARRARRAARAAKRAARHRARARARARRARA AD 


SUBTTL EQUATES, RECORDS. AND DATA STRUCTURES 
PAGE 


AARARAAARARARASHRARARHRIRARHRARRRARRARAARRRARRKRARKRHRARKRHARHARARARRARARARARAAAK AD 
WAAR RAR AA ARAM RARER RR RARER AAR OREM HRM M RMR R RRNA PRAM ERROR AAAS 
f EQUATES ANDO DATA STRUCTURES 

ARAARARARAARAAARRARARARHARAHRARARHRARRARRERKARKREDARREHRAKRAEHRARAHRAHRKRRARRRAREAE 
WUCUCELECTOCOOLOCSEVILECOOCOVOC OST TT CE TeCeCPeLeeererrrererereee rer eye? 


RARARARAARARARARAHRRAAARAROA GENERAL EQUATES RRARRARSEARARAREKRARARAARARAR 


» 0000 FALSE EQU 0 

*-0001 TRUE EQU NOT FALSE 

« O£BUG EQU TRUE 
.* MS-DOS INSTALLABLE DEVICE DRIVER EQUATES. RECORDS. AND STRUCTURES ** 
» STRUCTURES 
REQ_HEADER sTRUC Initialization Request Header 

structure definition 

0000 6(7? RH_ LENGTH 0B ? Length of Request Header 

0001 ?? RH UNIT_COOE DB ? Unit code 

0002 77 RH CMD CODE 8? Command code 

0003 7777 RH_STATUS Ow ? Returned status 

0005 = 7277777777772777? RH_ RESERVED 0Q ? Reserved for MS-DOS 

o00D 7? RH_UNIT_CNT og ? JUnit count 

OOOE 7777 RH_END_OFF Ow ? Offset of ending address 

0010 7777 RH END SEG Ow 7 ‘eee eed of ending address 

OO12 27777777 RH B8PB 00 ? :BPB Pointer (not used) 

0016 77 RH_ORIV OB ? Drive code {not used) 

0017 REQ_ HEADER ENOS 

= 0012 RH_CMD_LINE EQU DWORD PYR RH_BPB :On INIT entry, points to CONFIG SYS 

:command line {i @ all after DEVICE=} 

RECORDS 


ATTR RECORD DEV:1, IOCTL 1. IBM 1. X 1, OCREM 1. ¥ 6, SPEC 1, CLK 1, NUL 1, STOO 1, STOT 1 


.DEV_= 1 for character device. O for block device 

,IOCTL © 1 4f YOCTL commands are ed ree 

;18M = 1 if block device is in non-IBM format 

:X s Not used. 

.OCREM = 1 if character device puspotts open and 

; close commands. i if block device has 
removable media 

Not used 

Ce 1 af INT 29H fast console I/O is installed 


Ye 
SPE 
CLK «@ 
NUL ® 
:$TO 
$TD 

1 


1 if device 18 a clock device. 

1 if device is a nul device 
O« i if device is the Standard Output device 
I= 1} if device is the Standard Input device 


STATUS RECORD ERROR: 1, 2:5, BUSY 1, DONE:1, ERR_TYPE 8 
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94 ERROR = 1 if error condition detected 
95 2 = Not used 

96 BUSY © 3} if device buty 

97 .DONE = | when command completed 

a. ERR TYPE «© Error type See equates next 
eo EQUATES 

104 

ae Error codes Returned as part of status word defined above 

1 

G4 * 0000 MSD WRITE PROT EQU. OOH write protect 

105 * G00! MSO UNKNOWN UNIT EQU O1H unknown unit 

106 ® 0002 MSD NOT: ROY EQU O2H ,device not ready 

107 « 0003 MSD UNKNOWN CMO EQU 03H unknown command 

108 « 0004 MSO .CRC ERROR EQU. 04H CRC error 

109 * 0005 MSD BAD LENGTH EQU O5H bad driver request structure length. 
110 » 0006 MSD SEEK ERROR EQU O6H seek error 

wd * 0007 MSD UNKNOWN MEDIA EQU .O7H -uAknown media 

ile = 0008 MSD SEC_NOT FOUND EQU 08H sector not found 

413 » 0009 MSD PAPER OUT EQU O9H paper out 

Ll4 e QOOA MSO WRITE FAULT €QU OAH write fault. 

415 » 060B MSD READ FAULT EQU O8H read fault 

ae » 000Cc MSD GEN FAILURE; EQU OCH general failure 

i Commands 

120 * 0000 MSO INIT EQU OOH Initialize 

121 » 0001 “ MSO MEDIA_CHK EQU 01H Media check 

122 « 0002 MSD BLOB EQU O2H Build BIOS Parameter Block (BPB) 

123 » 0003 MSD IOCTL IN EQU 03H ,IOCTL input 

124 » 0004 MSO INPUT EQU O4H .Input from device 

125 * 0005 MSD IN NOWAIT EQU OSH Non-destructive. no-wait input 

126 « 0006 MSO IN STATUS EQU O6H ‘Return status of input device 

127 » 0007 MSD IN_FLUSH EQU 07H Flush input buffer 

128 » 0008 MSD OUTPUT EQU O8k Output to device 

129 * 0009 MSO OUT VERIFY £QU OSH Output with verify to device 

130 « OOOA MSD OUT STATUS EQU OAH Retur. status of cutput device 

131 « Q0O0B MSD OUT FLUSH €QU OBH Flush output buffer. 

132 * 000C MSO YOCTL_OUT EQU OCH -TOCTL output. 

133 * 0000 MSO DEV OPEN EQU OOH Open device 

134 » OOOE MSO DEV. CLOSE EQU OEH - Close device 

tae « OOOF MSD REM MEDIA EQU OFH Removable media check 

a .MS-DOS equates 

i 

139 « 0009 PRINT STR EQU O8H - .MS-O00S print string function number. 
wh = 0021 DOS ENTRY EQU 21K MS-DOS interrunt. 

142 ASCII] equates 

143 

144 » QOOA LF EQU QAH 

ae =» 0000 . ; CR EQU ODH 

we ae anaaeeeee EX-BIOS DRIVER EQUATES, RECORDS, AND STRUCTURES “"ernaanne 

tee “STRUCTURES 

ie HP HEADER STRUC -HP Oriver Header 

$3 0600 9000 OH ATR DW 0 ‘Driver attribute. 

194 0002 0000 OW NAME INDEX OW O .Index number for driver string. 

155 0004 0000 OH V. DEFAULT Dw 0 a a 

156 0006 0000 OH P_ CLASS dw O Driver parent class. 

1$7 0008 000 OH C CLASS OW 0 Driver child class 

198 GOOA 0000 DH V_ PARENT OW 0 :Vector number of driver's parent 

199 Q00C 9000 OH V CHILO OW 0 Vector number of driver's child. 

160 OQOE 00 DH MAJOR 0B O ‘Major address of device 

161 OQOF 00 OK MINOR 0B 0 ‘Minor address of device 

$62 ' 

163 0010 HP HEADER ENOS 

164 ? 

165 

ae OESCRIBE STRUC Physical describe record 

16 

i68 0000 7? O SOURCE OB ? ‘Upper nibble contains GID type 

169 | ‘Lower nibble HP-HIL address 

170 000), ?? DO _HPHIL 10 0B ? Device ID byte returned by HP-HIL device. 
17) 0002 7? D DESC MASK OB ? £2777 

172 0003. ?? 0 10_MASK OB ? .I/O0 descriptor Bye from device. 

173 ooh4 77 0 XOESC MASK OB ? :Extended descriptor byte from device. 
174 coCcS) 7? D_MAX_ARIS OB ? ‘Maximum number of axes reported by device, 
175 .0006 77 OD CLASS OB ? ‘Device class. 

176 : :Upper nibble contains current class. 
177 -Lower nibble contain default class. 
178 0007 7? O PROMPTS 0B ? .Number of buttons/prompts 

179 Upper nibble contains number of prereae: 
180 :Lower nibble contains number of buttons. 
48) oons 77 D RESERVED OB ? Reserved 

182 0009 77 O BURST _LEN OB ? :Maximum burst length. 

183 OCOA 7? DowR REG DB ? .Number of write registers supported. 
184 OOOB 77 D RO REG DB ? -Number of read registers supported. 
185 qo0c 7? D TRANSITION OB ? :Transitions reported per button 

186 0000 =?? OD STATE OB ? Current state of buttons. 

187 QOOOE 7777 DO RESOLUTION Dw ? ;Counts/em returned by device. 
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188 0010 72272 
189 0012 792% 
190 0014 7777 
191 0016 7279 
192 0018 7999 
193 OO1A 7777 
194 001Cc 779% 
195 COLE 9777 
196 
197 0020 
198 
199 s Q004C 
200 
201 
202 
203 
HARE 1, 
204 
205 
206 
207 
208 
209 «» 0006 
210 
21) =» 00:2 
212 e 0064 
213 « COOA 
214 
215 =» OO2A 
216 » 0000 
217 = 0002 
218 a 00046 
219 
220 *« 000C 
221 
222° e oocc 
223 *« 0002 
224 
225 « OO6F 
226 
227 
228 
229 = 0009 
230 *» 0040 
231 * 0041 
232 ® 00462 
233 « 0043 
234 
235 
236 
237 * 0000 
238 »® 0002 
239 » 0006 
240 ® OOFE 
241 « OOF6 
242 
243 
248 
245 
246 
247 
248 
249 
250 
251 
252 
253 0000 
254 
255 
256 0000 
257 
258 0000 
259 
260 
261 
262 0000 FF FF FF FF 
263 0004 8000 
264 0006 0265 R 
265 0008 O270 R 
266 QOOA 20 32 33.32 4D 53 
267 48 20 
268 
269 
270 
271 0020 
272 
273 *« ACIS 
274 0020 AC18 
275 0022 0003 
276 0024 0000 
277 0026 0000 
278 0028 0000 
279 002A oO0cc 


O_ SIZE_X Dw ? Maximum count along X axis in unite 
O SIZE Y Ow ? Maximum count along Y axis in units 
DABS X Ow ? Absolute data device X motion. 
0 ABS Y Ow ? Absolute data device Y motion 
D_REL Xx Ow ? Relative data device X motion. 
D_REL_Y Ow ? Relative data device Y motion 
0” ACCUM_X Ow ? X axis sealing sccumulator 
D_ACCUM_Y Ow ? Yo awaa scaling accumulator 
DESCRIBE ENOS 
MSE_NUM_BUTTON equ OO4CH Offset of number of button in mouse 
RECORDS 
HP_ATTR RECORD HP:1, DEVCFG 1, ISR-1, ENTRY-1, TYPE 3, STR 1. MAP CALL 1, A 
CSHARE 1, ROM 1, Bl 
EQUATES 
.EX-BIOS driver vector addresses and driver function numbers 
V_DOLITTLE EQU OOO6H .DOLITTLE driver vector address (NUL 
V_SYSTEM EQU 0012H /SYSTEM driver vector address 
FINS BASEHPVT EQU 04H 
FUINS XCHGFREE EQU OAH 
V_SINPUT EQU OO2AH INPUT driver vector address 
F-ISR EQU OOK 
F SYSTEM EQU 02H 
F-ITO_CONTROL EQU 04H 
F_INQUIRE_ ENTRY EQU OCH inquire about PGIO CS IP 
V_LHPMOUSE EQU OOCCH -LHPMOUSE driver vector address 
SF_MOUSE OVERRIDE EQU 02H 
HP_ENTRY EQU BFH .EX-BIOS interrupt number 


TSR Event Record data types 


T_KC_BUTTON EQU 09H Button data type. 
TRETOB EQU 40H 

T_RELIB £QU 41H 16 Bit relative motion data type 
T_ABSO8 EQU 62H 

T_ABSi6 EQU 43H 

.EX-BIOS Return Status Codes 

RS SUCCESSFUL EQU OOH 

RS UNSUPPORTED EQU 02H 

RS" DONE EQU O6H 

RS"FAIL EQU OFEH 

RS" NO_VECTOR EQU OF BH 


; MA AAAAARAARAARAAARARAAAAERRARARAAAAARRARRRAAAREA RARER ARRORARRARRRRARALOR 


SUBTTL CODE SEGMENT 


“PAGE 


SAAAARAARARRAARABARAAAARAARARAARAARAARARRAERARARAARRRAAARARAARARRARA BRED 
AAARAAARARARARAARAAAARAAAARAAAARRARRARRAHARARRRARARARRARARERHRARRRARAAAD 


CODE SEGMENT 


OEP E OEE EE LeVrerrrrerrrerererrrrr ert e rr tre errr rr e rr nnn 
‘ 
AAMARARRARRAEAARRAARARARHARAAAAARERARERAAHARRRARAARAAREREARARRRARRRERARE 


SEGMENT 
ASSUME 
ORG 


PUBLIC ‘CODE’ 
tg CODE. OS NOTHING 


CODE 


Must be org'd at 0 to be a device d 
DEV_ORIVER PROC FAR 


MS-DOS DEVICE ORIVER HEADER 


oO -1 -Link list entr Must be set to -1 
ORIVER_ATTR OW ATTR«1,0,0,0,0,.0,0,0.0.0> Driver attribute 
STRAT ENT Ow OFFSET DEV_ STRATEGY Device strategy entry point 
INT ENT OW OFFSET DEV_INTERRUPT Device interrupt entry point 
ORIVER. NAME 0B 232MSE ' ‘ 


@aannaann 


EX-BIOS DRIVER HEADER AND PHYSICAL DESCRIBE RECORD 
ORG 20H Make sure its paragraph aligned 


EQU HP_ATTR<«1.0,1,0,86,0.0,0.1.1.0,0> 
HP_HEADER<OEV ATTRA. 3.0.0.0, V_LHPMOUSE ,V_DOLITTLE.0.0> 


of resolution 
of resolution. 


RAM 


1, SUBADO 2, PS 


driver) 


river 
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280 002C 0006 

281 OO2E 00 

Ae OO2F 00 

gee eeee Bn DEV_DESCRIBE DESCRIBE <2.0,0,0.0,2,0,20H.0.0,0.0,1,O0FFH,2000,0,0,0,0,0.0.0,0> 
286 0032 00 

287 0033 00 

288 0034 00 

289 0035 02 

290 0036 00 

291 0037 20 

292 0038 00 

293 0033 00 

294 003A 00 

295 0038 00 

296 003c Ok 

297 0030 FF 

298 OO3E O00C8 

299 0040 0000 

300 0042 0000 

301 0044 9000 

302 0946 0000 

303 0048 9000 

304 004A 0000 

305 004C 0000 

306 OO4E 0000 

307 
ane RR RRARARARA RARER ARR A ARR AAA RARE RRA RA RAR ARO RAR AKER RAR ARR EAA RRARARK RARE RSD D 
310 at CODE SEGMENT RELATIVE DATA AREA a 
311 [RA ARAARAAARER AAR RA ASAATAARAARARRARRAREHARRARAHRAARHAEAROSERRERERAAARRAS 
312 
913 _ARRRRAARR ARH AARAD DATA AREA FOR mS -00S ORIVER PORTION RARARRAARRAARARAR 
314 
315 0050 o0cd REQ_ HOR: OFF Ow O ‘Storage for offset of device strategy header. 
ae 0052 0000 REQ_HDR_ SEG OW 0 Storage for segment of device strategy header. 
1 
318 0084 $2 53 20 32 33 32 SIGN_ON_MSG DB 'RS-232 INPUT SYSTEM MOUSE DRIVER 
319 20 49 4£ $0 55 $4 
320 20 53 59 $3 $4 45 
a2t 40 20 40 4F 55 53 
322 45 20 44 52 49 56 
323 45 52 20 20 
324 0076 28 43 29 43 6F 70 DB '(C)Copyright Hewlett-Packard 1985° CRLF 
325 79 72 69 67 68 74 
326 20 48 65 77 6C 65 
327 74 74 20 $0 61 63 
328 6B 61 72 864 20 31 
329 39 38 35 00 OA 
330 0099 56 65 72 73 69 4F VERSION_LAB DB ‘Version A.O1.01' CR LF, 'S' 
331 6€ 20 41 2E€ 30 31 
332 2E— 30 31 00 OA 24 
333 « 0010 VERSION _LEN EQU $-VERSION LAB-2 
334 OOAB 4D 6— 75 73 8S 20 OK _MSG DB ‘Mouse installed on COM’ 
335 69 6— 73 74 B1 86C 
336 6C 65 64 20 6F 8E 
337 20 43 4F 40 
338 o00cl a 3A 0D OA OD OA COM_MSG OB '0:',CR,LF,CR,LF,'S' 
339 . 
340 oocs 53 70 65 63 69 66 NO_PORT_MSG OB ‘Specified COM port not present. Driver not installed.’ ,CR,LF,CR,LF, 
341 69 65 64 20 43 4F 

342 40 20 70 6F 72 74 
343 20 6E BF 74 20 70 
344 72 65 73 65 6E 74 
345 2— 20 20 44 72 69 
346 76 68 72 20 6E OF 

347 74 20 69 6E 73 74 
348 61 6C 6C 6S 84 2E 
349 00 OA OD OA 24 ae 
350 0103 55 6E 6: 62 6C 85 NO_VECTOR DOB ‘Unable to inetall PGID driver.’ ,CR.LF,'$ 

351 20 74 GF 20 69 8E 

352 73 74 61 6C 6C 20 
383 50 47 49 44 20 64 

354 72 69 76 6S 72 2E 

355 QD OA 24 

385 0124 0000 

5 1 0 STACK_PYR OW 0 Storage for existing stack frame. 
58 0128 9000 STACK” SEQ OW 0 a bas oe 
360 0128 0000 COM_NUMBER Ow 0 :Offset into COM port base address table 
361 :found at 0040:0000H. 

362 012A 0030 INT_TABLE DW OCH * 4 ;COM1 port interrupt. 

ei HE. e36 Pu oon: aoe vert terrae: 

A port interrupt - set as appropriate. 

365 0130 oo2Cc OW OBH * 4 :COM4 port interrupt -_ set as appropriate. 
366 Q132  FFEF MASK TABLE OW NOT O1H SHL 4 :COM1] interrupt mask (IRQ4). 

367 0134 FFF? OW NOT O1H SHL 3 ;COM2 interrupt mask (IRQ3 

368 0136 FFEF Ow NOT O1H SHL 4 -COM3 interrupt mask (IRQ4 

48 0138 FFF? OW NOT O1H SHL 3 :COM4 interrupt mask (IRQ3 

371 013A 0000 FRAME COUNT Ow Oo ‘Frame counter for mouse data packet. 
ae 013C os [ ao TEMP BUFFER 08 $5 DUP (0) :Temporary buffer for mouse data bytes. 
374 } 
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37§ 

a QO141 87 LAST_SYNCH OB 87H Copy of last synch byte. 

ate 0142 OE [ Be HPHIL TABLE DB 14 DUP (0) -HP-HIL configuration table 

280 ] 

381 , 

382 0150 00 HPHIL ADD 0B O -HP-HIL ‘address’ of mouse 

a 0151 00 PGID_VECT_NUM dB O .HP_VECTOR_TABLE vector address of PGIO. 
Be , JUMP TABLE FOR MS-DOS DRIVER COMMANDS 

387 O1S2 O2A7 R CMD_TABLE OW OFFSET INIT CODE -Initialize driver. 

388 0154 0292 R OW OFFSET UNSUPPORT CMD :Media check. 

389 C156 0292 R OW OFFSET UNSUPPORT CMD .Build BPB 

390 0158 0292 R DW OFFSET UNSUPPORT CMD .IOCTL input. 

391 O1SA 0292 R Dw OFFSET UNSUPPORT CMD -Input 

392 015C 0292 R OW OFFSET UNSUPPORT CMD .Non-destructive input. 

393 O1SE O0292.R OW OFFSET UNSUPPORT CMD .Input status 

394 0160 0292 R OW OFFSET UNSUPPORT CMD .Flush input buffer. 

395 0162 0292 R DW OFFSET UNSUPPORT_ CMD Output. 

396 0164 O292 R DW OFFSET UNSUPPORT CMD Output with verify. 

397 0166 0292 R DW OFFSET UNSUPPORT CMD ,Output status. 

398 0168 O292 R DW OFFSET UNSUPPORT CMD :Flush output buffer. 

399 O16A 0292 R OW OFFSET UNSUPPORT CMD -.IOCTL output. 

400 O16C 0292 R OW OFFSET UNSUPPORT CMD .Open device 

401 O16E O292 R OW OFFSET UNSUPPORT CMD .Close device. 

ae 0170 0292 R OW OFFSET UNSUPPORT_CMD .Removable media check. 

404 AA AARARHARARRARAE DATA AREA FOR EX-BIOS DRIVER PORTION RARARRRARRARARA 
405 

406 PAGE 

a RRA ARRARARAARAARRARRRRA AREA ARAARRAARARAR AA RRAAAR ARERR AANA R ARATE 
409 vs MOUSE DRIVER CODE * 
410 RRM RAMA ARR RA RARER RAR ARR A REAR RR AAA RARER ARR ARR AER RAR R ARERR RAR RARER ES 
41\ 

412 0172 MOUSE _INT 

413 

414 “PRESERVE MACHINE STATE 

415 ‘ 

ale 0172 9C PUSHF :Save the registers. 

417 C173 .60 PUSHA 

ai9 0178 06 PUSH OES 

4. 0175 

420 0176 8C C8 MOV AX.CS Re-establish data segment addressibility. 
2a 0178 8E& D8 MOV DS, AX 

4 

423 -ISSUE END-OF-INTERRUPT TO 8259A 

424 : 

425 017A 80 20 MOV AL, 20H ,EOT 

426 O17C €E6 20 OUT 20H AL 

427 

A28 :GET CHARACTER FROM MOUSE 

423 

430 O17E B8& 0040 MOV AX. 40H ‘Get base address of COM port from table. 
431 0181 8€ CO MOV ES AX 

432 0183 2E: 8B LE 0128 R MOV BX COM NUMBER 

433 0188 26: 8B 17 MOV OX,ES T[BX) 

434 

435 018B EC IN AL OX Get character. 

436 

437 -STORE IN TEMPORARY BUFFER UNTIL ENTIRE FRAME HAS BEEN RECEIVED 

438 ; 
439 018C 2E 88 1E O13A R MOV BX FRAME _COUNT ‘Get number of characters left in frame. 
440 0191 OB DB OR BX BX -See if we're looking for synch byte. 
44h 0193 75 OD INZ MSt 1 ‘Jump if not. 

442 0195 8A EO MOV AH AL -Save a copy of mouse character. 
443 0197 24 FB AND AL OF 8H ‘Mask off button bits. 

444 0199 3C 80 CMP AL, 80H ‘See if this is a synch byte. 

445 0198 8A C4 MOV AL ,AH :Get the original character back. 
446 019DB 74 03 JZ MST 1 -Put character in temporary buffer if synch 
847 " -byte is valid. 

448 Ol9F E9 O260 R JMP MST_5 ‘Otherwise, throw character away. 
449 

450 O1A2 2E€: 88 87 O13C R MST_1: MOV TEMP _BUFFER([B8X] ,AL Store character away. 

451 O1A7? 483 a INC BX Update the frame counter. 

452 O1A8 2E: 89 1E O13A R MOV FRAME COUNT , BX -And save it. 

453 OL1AD 83 FB OS CMP Bx ,5 ‘Is this the last character in frame? 
454 0180 74 03 JZ MST 2 Process the frame if so. 

455 O182 €E€9 0260 R JMP MSI-5 ,Otherwise, skip on. 

456 

457 CHECK FOR A CHANGE IN BUTTON STATE 

458 

459 0185 8B 0000 MSI_2: MOV Bx, 0 New character count. 

460 G188 2E: 89 1E OLIA R MOV FRAME COUNT ,BX Store it. 

461 O1BD 2E&: 8A 87 O13C R MOV AL, TEMP BUFFER[BX] :;Get synch byte. 

462 01C2 E. 8A 26 0141 R- MOV AH, LAST SYNCH -Get last synch byte. 

463 O1c7 2€. A2 O141 R MOV LAST. SYNCH, AL :Update Last byte. 

464 01CB8 3A EO CMP AH, AT :See if they are the same. 

mea 0o1cD 74 $6 JZ MSI_3 ‘Skip on tf se {no change in button state). 
467 ;SEND BUTTON ISR EVENT RECORD(S) TO INPUT SYSTEM 
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468 ‘ 
469 O1CF $3 PUSH Bx .Save frame counter. 
4706 0100 $2 PUSH OX Save 
47) 0101 32 £0 XOR AH. AL .AH now holds mask of buttons that have changed. 
472 0103 B7 O1 MOV BH O1H Mask for first button 
re 0105 89 0003 MOV Cx 3 .Number of buttons to process 
475 91D8 -MBUTTON: 
476 0108 8A DC MOV BL AK :Get a copy of change. mask 
477 O1DA 22 DOF AND BL BH See if eelectad button was the one that changed. 
478 O1i0C 74 41 JZ MNEXT BUTTON .Skip on af not 
479 O1DE 84 F8 TEST BH. AL ,Determine state (make or break) of selected butt 
ran OLEO 74 04 JZ MBUTTON_DOWN 
oe O1E2 MBUTTON_UP 
484 O1E2 B3 80 MOV BL, 80H :Set bit 7 (make/break bit) to O (break). 
ae2 O1E4 EB 02 JMP SHORT MBUTTON_ISR 
ae O1E6 MBUTTON_ DOWN. 
re O1f€6 B63 00 MOV BL, OOH Set bit 7 (make/break bit) to 1 (make). 
491 O1E8 MBUTTON_ISR. 
492 O1E8 §3 PUSH BX 
493 O1E9 &8B O9 MOV Bx, CX 
494 OQ1iEB 32 FF XOR BH, BH 
4gs O1ED FE CB DEC BL 
496 OlEF 2E: 8A 8F O1F7 R MOV CL, CS BUTTON TAB[BX] 
497 OlF4 58 PoP Bx 
498 Ol1FS EB 03 JMP SHORT BISR2 
499 OlF7 CO BUTTON_TAB 0B 0 left button 
$00 Ol1F8 02 OB 2 middle button 
501 O1F9 Q2) 08 i right button 
§02 O1lFA BISR2. ° 
503 Ol1FA OA O09 OR BL, CL 
eee O1FC 32 FF xOR 8H. BH clear out bh 
ie) 
506 O1FE 50 PUSH AX ,Save registers 
507 OLFF 53 PUSH BX 
508 0200 51 PUSH Cx 
503 0201 JE PUSH os 
510 
Sid gage 
ae Create ISR Event Record 
$14 0202 86 09 MOV OH,T_KC_ BUTTON Set data type. 
515 O2G4 2€ 8A 186 O151 R MOV OL, PGID_VECT_NUM .Get vector number of mouse's PGID 
$16 0209 869 0000 MOV cx,.o .Burst length (N/A). 
517 O20C 8C C8 MOV AX.CS Point ES to driver header 
518 O20E 40 INC AX 
$19 O2CF 40 INC AX 
520 0210 8€ CO MOV ES AX 
521 0212 864 00 MOV AH.F_ISR Set ISR function 
522 0214 8D 002A MOV BP, V_SINPUT We're calling the INPUT driver 
$23 0217 FA ; CLI .Turn off interrupts while we're out 
$24 0218 CO &6F INT HP _ENTRY 
2e2 O21A FB STI Re-enable interrupts 
2 
$27 02:18 IF POP oS 
528 021C 59 POP Cx 
§29 0210 58 PoP Bx 
ze O21E 58 Pop AX 
1 
gas O2\F MNEXT BUTTON. 
534 O21F DO E7 SHL BH.1 ‘Move button selector mask to next button. 
$35 0221 €E2 B85 LOOP MBUTTON 
536 0223 SA POP Ox :Restore 
537 0224 SB PoP BX ;Get frame counter back. 
538 
oe , CHECK: FOR MOTION 
54 
541 0225 43 MST_3. INC Bx Point to first delta X in buffer. 
§42 0226 2€ 8A 97 O13C R MOV DL, TEMP BUFFER[BX) 
$43 022B 43 INC Bx Get first delta Y. 
S44 O22C 2E 8A B7 O13C R MOV OH. TEMP_BUFFER{BX) 
$45 0231 43 INC BX ,Add second delta X to first. 
546 0232 2€ O2 97 013C R ADD OL. TEMP_B8UFFER{[BX) 
547 0237 43 INC Bx Add second delta Y to first. 
eae 0238 2E€ O2 87 O13C R ADO OH, TEMP_BUFFER[BX) 
550 0230 O08 D2 MSI_4@: OR OX OX :;Check for zero motion. 
551 O23F 74 1F 3 32 mMSt 5 ‘Skip on if none detected. 
$52 
$53 ee e 
eee ;SENO MO TaN ISR EVENT RECORD TO INPUT SYSTEM 
556 0241 8A C2 . MOV AL OL ‘Convert delta X to 16 bit value and put 
$s7 0243 98 CcBw :At in ISR Event Record (BX register). 
558 0244 8B D8 MOV BX AX 
556 0246 8A C8 MOV AL DH :Ditto for delta Y (CX register). 
560 0248 98 CBw 
$61 0249 8B C8 MOV CX AX 
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562 

563 ;Create motion ISR event record 
564 024B B6 41 MOV DH, T_REL1I6 ‘Set ISR Event record data type to 16 bit 
565 :relative motion 
566 0240 2€. 8A 16 O151 R MOV OL. PGID_VECT_NUM Get vector number of mouse’s PGID. 
569 0252 8C C8 MOV AX.CcS ;Set £S.0 to driver header. 
568 0254 40 INC AX 
569 0255 8& CO MOV ES AX 
§70 0257 B84 00 MOV AH.F_ISR :Select ISR function 
571 0259 BD 002A MOV BP, V_SINPUT ‘We're passing this on to the INPUT driver. 
572 O25C FA CLI :Interrupts are supposed to be aff. 
$73 0250 CD 6F INT HP_ENTRY 
one O25F FB STI :Turn interrupts back on now. 
at: ;RESTORE MACHINE STATE AND EXIT 

7 
578 0260 O07 MST_5: POP ES 
579 0261 IF POP os 
580 0262 61 POPA 
581 0263 90 POPF 
$82 0264 CF IRET 
583 
584 PAGE 
ee MAA RA RARE RARARARARRAARERARAAERRRAARRAAARAKKRAARHRARRAARKARAAKRARRAARAARA 
587 —< MS-DOS DRIVER CODE s 
S88 BARRA RARARRARAAAARRARAARARRARRRARARARRARRALRARARRARHRAARRRAREREARRARR A 
es _RRRARRRRARRERAERARRRARRRE STRATEGY ENTRY POINT ARAERRARARARARAKRRRARRAARARR 
$91 
592 0265 DEV_STRATEGY PROC FAR 
$93 0265 2& 89 1E OOSO R MOV CS REQ HOR OFF BX ‘Save offset of request header. 
594 O2Z6A 2E 8C 06 0052 R MOV CS:REQ_HOR_SEG,ES ;Save segment of request header. 
595 O26F CB RET ‘Return to MS-DOS. 
$36 9276 DEV_STRATEGY ENDP 
ee _RARRRARARARARARKRAARRRER INTERRUPT ENTRY POINT RAAKAKRRARKRAARARAARRARRAR 
599 
6095 0270 DEV_INTERRUPT PROC FAR 
601 
602 ;SAVE MACHINE STATE 
§03 C270 gC PUSHF 
604 O271 FC CLD 
605 0272 60 PUSHA Save registers. 
696 G273 8C CF MOV DI.cSs ;Set DS to CS. 
607 0275 8E& OF MOV Os DI 
E08 
699 .FETCH COMMAND FROM REQUEST HEADER 
€10 0277 2€ C4 3E 0050 R LES OI ,DWORD PTR REQ HOR OFF Move address of request header into ES:DI 
611 027C 26 8A 45 02 MOV AL.ES [DI] RH _CMO_COBDE .Get command byte from header 
612 0280 3C 00 CMP AL,MSD_INIT ‘Perform range check on command byte. 
613 0282 72 OE JB BAD_CMD 
614 Q284 3C OF CMP AL ,MSO_REM MEDIA 
615 0286 77 OA JA BAD_CMO 
616 0238 98 CBW Convert command into jump table offset 
6i7 0289 61 EO SHL AX, 1 
618 O28B 88 D8 MOV BX , AX 
028D 2E: FF A7 0152 R JMP CMO_TABLE([BX) ‘Dispatch to requested function. 
62 
ae ,EXIT POINT FOR BAD OR UNSUPPORTED FUNCTIONS 

22 
623 0292 BAD CMD: 
foe 0292 UNSUPPORT_CMD: 

ze) 
626 0292 26: 81 4D 03 8000 OR ES:(DI).RH_ STATUS, MASK ERROR <;Set error flag in return status word. 
627 9298 26. 81 40 03 0003 OR ES: {D1} .RH_STATUS, MSD_UNKNOWN_CMD .Set error code. 

6238 

629 , COMMON EXIT POINT 

620 

631 O29E 26. 81 4D 03 0100 EXIT: OR ES: [O1)].RH_STATUS, MASK DONE Set return status to done. 
632 C2A4 61 POPA ‘Restore registers. 

633 O2A5 9D POPF Restore digi be 

634 O2A6 CB RET ‘Return to MS-DOS. 

635 

Rae , RAARAARARARRAARRARRARAR END ‘OF RESIDENT CODE RARKRRRARRAAARAARARRARRAAR : 
638 PAGE ; 
639 RRA RRA RARER RAR RRA RRR INITIALIZATION CODE RARRARRARARAARRARRRARRARRR 
£40 i 
641 0247 INIT. CODE - 
642 
643 .SET UP LOCAL STACK 
644 O2A7 FA CLI ;Disable interrupts while we're messing with stack. 
645 
646 O2A8 BE O124 R MOV SI,OFFSET STACK _PTR Store existing stack environment. 
647 C2ZAB 89 24 MOV [sti st 
648 O2AD 83 C6 02 ADD I 
649 0280 8C 14 MOV (st],ss 
65 
651i 0282 BC O511 R MOV SP OFFSET CS:STACK_TOP <.Set up our local stack. 
652 0285 8c C8 MOV AX,CS Stack segment is same as code (CS) 
-653 0287 8£— DO MOV SS AX 
654 

655 0289 FB STI ;Re-enable interrupts. 
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ON MESSAGE 


DX OFFSET SIGN _ON MSG 
AH PRINT STR 
DOS ENTRY 


PARSE CONFIG SYS COMMAND LINE TO. DETERMINE WHICH COM PORT THE MOUSE IS ON 


Bx,0 
OI.E€S (O01) .RH_CMO_LINE 


AL BYTE PTR ES: [DI+BX]} 
ALY: 
IC 2 
ALTCR 


IC_3 
AL LF 


1¢ 3 
ax 
IC} 


BX 
AL BYTE PTR ES (DI+BX) 
ALS UY" 

IC 3 

AL 73 

Ic_3 


AX. 
COM NUMBER , AX 
SHORT IC_4 


COM_NUMBER ,0 


BX AX 

Bx .1 

BL. 1° 

COM_MSG BL 

SERTAL PORT PARAMETERS . 


OI AX 
AX, 40H 


AX 
OX,ES.[01) 
DX 


4A 
INTT_NO_PORT 


Clear existing error or character 


.PRINT SIGN- 
O2BA BA 0054 R MOV 
Oc285. B4 09 MOV 
OzBF CD 21 INT 
C2c1 BB o000 MOV 
C2C4 26 C4 70 12 LES 
C2cé 26 8A O1 Tcl MOV 
O2CB 3C 2F CMP 
C2ecD «674 OB JZ 
o2cK 3C OD CMP 
O20. 74 1C JZ 
0203 3C OA cme 
Ceos 74 18 Jz 
Czd7) «43 INC 
C208 EB EE JMP 
O2DA 43 Ic 2 INC 
O20B 26 8A O01 MOV 
OZDE 2¢ 31 SUB 
C20 72 Gd JB 
OLt2 3C 03 CMP 
N2F4 77 09 JA 
QcEE 98 CBW 
92£7 O1 £0 SKL 
O2E9 2E— AZ 0128 R MOV 
O2ED £B 97 JMP 
O2EF 2E& C7? 06 9128 R 0000 1c_3 MOV 
C2F& 88 D8 Ic_4 MOV 
O2F8 O61 EB SHR 
G2FA 80 C3 31 ADD 
O2cFD 2E€ 88 LE OOC1L R MOV 
0302 FA cul 
SINITIALIZE 
0303 8B F8 MOV 
0295 68 0040 MOV 
0308 8€& CO MOV 
C30A 26 88 15 MOV 
9300 OB De OR 
O30F 75 03 INZ 
O311 E9 0382 R JMP 
03146 83 C2 05 TC_4A ADD 
0317 EC IN 
0318 EB 00 JMP 
:Set baud 
O31A 83 EA 02. SUB 
0310 80 80 MOV 
O31F €€ QUT 
0320 EB 00 JMP 
0322 83 EA 03 SUB 
0325 BO 60 MOV 
O327 EE : OUT 
0328 EB 00 JMP 
032A 42 INC 
0328 BO 00 MOV 
O32D EE ouT 
O32E EB 00 JMP 
iInitialize 
0330 83 C2 v2 ADD 
0333 BO 03 MOV 
0335 EE OUT 
0336 EB O00 JMP 
;Inditialize 
0338 4&2 ‘ ; INC 
0339 BO OB MOV 
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Ox.s 
AL ,OX 
SHORT $+2 


rate divisor to 1200 baud 


DX 2 
AL. 80K 
OX. AL 
SHORT $42 
Ox.3 


line control 


DX 2 
AL 03H 

OX AL 
SHORT $+2 


register. 


modem control register 


Ox 
AL,OBH 


‘Clear Bx Tt will be used as 
-command line 

.Load ES OF with pointer 
cline 


index into 


to CONFIG SYS command 


Get next character in command line 
Check for backslash 
If found indicates 
Check for carriages 

:set of parameters) 

If found. stop scanning command line 

Check for line feed (Indicates no parameters 
entered in command line 

If found, stop scanning command line 

Else, point to next character, 

and continue scanning command line 


start 
return 


of parameters 
(Indicates a dogas 


Get next character 
.to use Valid range ts 1 - 
Convert number into offset from 1 


Perform range check on results 


Should indicate COM port 
4 


Convert into offset into STO-BIOS COM port 
:base address table at 0040 OOOOH 


Save it for future use 


Pe 
.Tf we wind up here. there were no parameters 
PN ores in the command line. or an invalid 
Cc 


M port was specified Set COM port COMI 
default. 
‘Convert offset into ASCII COM number (1 - 4) 


/Store in sign-on message 
Disable interrupts while mouse interrupt 
,is being set up. 


‘Move COM port table offset into DI. 
Segment address of COM port base address table 


:Get base address of COM port out of table 
‘Make sure port exists 
Continue with initialization if it does, 


,otherwise, go to error routine. 
Point to line control register 

Set line control register to divisor programming 
mode. 

uetay 

Point to divisor LSB register (dbase). 
;LSB for 1200 bps. 

ee 

;Potnt to MSB of divisor (base + 1). 
:MSB for 1200 bps. 

Delay. 


:Point to line control 


register [fare +3). 
/8 data bita, 


1 stop bit, no parity 
Delay. 


‘Point to modem control register (base + 4) 
/DTR and RTS set, OUT2 set to enable interrupts. 
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OUT 


DX AL 


748 0338 EE 
749 033¢ £EB 00 JMP SHORT $42 Delay. 
5 . x 
ie ,Imitialize interrupt enable register : ; 
753 O33— 83 EA 03 SUB OX 3 Point to interrupt enadle register {base + 1) 
15¢é 0241 BO Ol MOV AL.O1 -Enabdle Rx Data Ready interrupt 
ae 0343 €€E OUT OX AL. : : 
787 ;SET UP COM PORT INTERRUPT VECTOR © 
759 0344 2€: 8B 1E 0128 R MOV BX ,COM_NUMBER Get table offset back 
760 0349 2€- 8B BF O12A R MOV OF INT _TABLE[BX]} :Use it as index into interrupt vector table 
761 034—E 88 9000 MOV AX 0 Set —S to interrupt vector segmant (0 j 
762 0351 8€ MOV ES AX 
763 0353 B&8 0172 R MOV X OFFSET MOUSE INT Initialize vector 
764 0356 AB STOSW 
765 0357 8c C8 V AX.CS 
pee 0359 AB STOSW 
76 
cee [ENABLE MOUSE INTERRUPT ON 8259A INTERRUPT CONTROLLER 
770 O35A 2€: 8B 8F 0132 R MOV Cx MASK TABLE[BX] Get mask from table 
771 O35F E4 21 IN AL 21H Get current mask 
772 0361 €B 00 IMP SHORT IC_10 ‘Delay 
773 0363 22 Cl Ic_10 ANO AL .CL Clear mask for mouse interrupt 
ae 0365 €6 21 OUT 21H,AL Set new value 
ie 0367 FB ST? Re-enable interrupts 
778 0368 B64 OC MOV AH F INQUIRE ENTRY Return CS IP of PGID driver function 
779 036A 8D 002A MOV BP V_SINPUT 
780 0360 1€ PUSH oS 
781 O36E CD 6F INT HP ENTRY 
782 0370 IF POP OS 
783 0371 80 FC 02 CMP AH ,RS_ UNSUPPORTED See if brute force approach is necessary 
784 0374 75 06 JNE Intt 3 
785 0376 O€ PUSH cs Even the best laid plans of mice and men aft 
786 0377 O7 PoP ES go awry F_ INQUIRE PGID is not implemented in 
787 0378 80 1E O3FF R LEA BX. CS. PGID DRIVER some early ROM versions The PGID CS IP must be 
a hard coded for these systems 
790 037C 8B FB INIT_3. MOV OI, BX Move IP into OF 
791 O37—E 8C CA MOV OX.cs Get PGID's DS 
792 0380 83 C2 02 ADD OX, 2 account for ORG 20H 
793 0383 B4 OA MOV AH .F_INS XCHGFREE Exchange fixed vector address function 
794 0385 60 OOL2 MOV BP V SYSTEM 
795 0388 1€ PUSH DS 
796 0389 CD 6F INT HP ENTRY 
797 0388 IF POP OS 
798 038C 80 FC FE CMP AH, RS_NO_ VECTOR Is it installed in vector ‘table 
799 O38F 74 18 JE INtT_NO_VECTOR- 
801 0391 8B C3 MOV AX, BX Set up for the divide 
802 0393 83 06 MOV BL, 86 
804 0395 F6@ FI OIV BL Convert to a vector index 
ae 0397 2€ A2 O151 R MOV PGTO_VECT NUM, AL Save for ISR Events 
8C6 0398 64 04 MOV AH, F_TO CONTROL Now to make sure that the V LHPMOUSE 
807 0390 80 02 MOV AL, SF MOUSE OVERRIDE driver sets up INT 33H 
808 O39F 8D O0CC MOV BP. V_LHPMOUSE 
$09 O3A2 IE PUSH os 
810 O3A3 CO 6F INT HP_ENTRY 
Bil OAS LF POP os 
812 
we O3A6 £B 13 90 JMP INIT_OK 
i 
46 O3A9 INIT_NO_VECTOR 
1 
817 J3A9 BA 0103 R MOV OX OFFSET NO VECTOR Print error message 
818 O3AC B4 O9 MOV AH PRINT STR 
819 O3AE Cd 21 INT OOS_ENTRY 
820 O3B0 €8 14 JMP SHORT INIT _EXIT 
821 
Ha 03B2 INIT_NO_PORT 
8 
824 0382 BA OOCB R MOV OX OFFSET NO PORT MSG Print error message 
825 0385 B64 09 MOV AH PRINT STR 
826 0387 CD 21 INT DOS _ENTRY 
ae 0389 EB OB JMP SHORT INIT_EXIT 
ees 0388 INIT_OK: 
831 0388 ¢ cs MOV AXx,.CS Set DS back to proper vaiue 
832 0380 8€ D8 MOV OS AX 
833 O3BF BA OOAB R MOV OX OFFSET OK_MSG Print sign-on message 
834 03C2 B4 O89 MOV AH PRINT STR MS-DOS print string function number 
He o03c4 CO 21 INT DOS ENTRY 
oe 03C8 INIT_LEXIT. 
839 93c6 06 PUSH ES now to set the mumber of buttons 
840 93c7 «$0 PUSH AX V_LHPMOUSE has 
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841 03C8 B8& 0000 
842 QO3CB 8€ CO 

843 O03CO 26: 8E O08 OLBE 
844 0302 26 8€& 06 0000 
845 0307 26 C6 06 O04C 03 
846 030D $8 

847 O3DE 07 

848 

849 O3DF 2E— C4 3E 0050 R 
850 O3E4 26. C7 45 OE O4D1 R 
851 O3EA 26: 8C 40 10 
852 

853 

854 

855 O3EE FA 

856 O3EF BE 0124 R 
857 O3F2 8B 24 

858 O3F4 83 C6 02 
85.9 O3F7 8B 04 

860 O3F9 8E DO 

861 O3FB FB 

862 

863 O3FC £9 O29E R 
864 

865 O3FF 

866 O3FF 

867 

868 

869 

870 

871 

872 

873 

874 

875 

876 

877 

878 

879 

880 

881 

882 

883 

884 

885 

886 

887 

888 

889 

890 

891 

892 

893 

894 

895 

896 

897 

898 

899 

900 

901 

902 

903 

904 

905 O3FF 

906 O3FF 80 FC 00 
907 0402 75 04 

908 0404 £8 0414 R 
909 0407 CF 

910 

$11 0408 

912 0408 80 FC 02 
913 0408 75 04 

914 O40D E8 0496 R 
915 0410 CF 

916 

917 

918 

919 

920 

921 

922 o4il 

923 0411 B84 02 

924 0413 CF 

925 

926 0414 

927 

928 

929 

930 

931 

$32 
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MOV Ax, O 
MOV ES, AX 
MOV ES. ES:[HP_ENTRY * 4 + 2] 
MOV €s, ES:{v ab ave 
pont BYTE PTR ES:MSE_NUM BUTTON.3  -:Define the number of buttons to 3 
POP ES 
LES OI, DWORD PTR REQ HDR _OFF -Reload ES:DI with address of request header. 
MOV ES: (O01) .RH_ENO_OFF OFFSET END OF DRIVER .Return end of resident code to 
MOV ES: [O1}.RH_END_SEG,CS :MS-OOS. : 
,RESTORE OLD STACK FRAME AND EXIT 
CLI ‘Disable interrupts while working on stack frame 
MOV SI, OFFSET STACK_PTR :Get address of old stack storage 
MOV SP (ST) Restore stack pointer. 
AOD SI,2 Get old stack segment 
MOV AX) [SI A 
nay oh ] ,And restore it. 
STI :Re-enable interrupts. 
JMP EXIT 
DEV_INTERRUPT ENDP 
DEV_DRIVER ENDP 
page 


,SeeDRIVER HEADER senuncceseccnctewubtuauncuctnvccstucevaceeceeatuecsccs 
NAME: PGID_ DRIVER 
DESCRIPTION 


LIST OF FUNCTIONS: (function code in nae) 
(Those functions not listed are NOT SUPPORTED. } 


F_ISR 
F-SYSTEM 
PARAMETERS 
See function headers for specific values for other entry and exit 
parameters 
| REGISTERS PRESERVED: 
DEFINITION MODIFICATION HISTORY 
VERSION: 
DESCRIPTION OF CHANGES: 


' 
, SSFSSSSSSCASSLASSTSSSASSSSSHTSTSSSSHSASRHAHRSHATESSHASSHRTESETROCHHEHRHSSEKeE 


subttl PGIo Main entry point 


page 
osaume cs:CODOE, ds:nothing 
public PGIO_OR{VER 


NOTE **** No driver header for PGID **** 


Only 2 functions are supported: F_ISR, F_SYSTEM -- all others are unsupported 
pgid_ driver Proc near 
cmp ah. F_ISR ; F_ISR? 
jne check_f_ system 
call pgid_Isr 
iret 
check f_ system: 
cmp ah, F_ SYSTEM F_SYSTEM? 
jne pgid_ opcode bad 
call pgid_system 
iret function has set return code 


; Main opcode out of range of PGID functions supported 
just return RS UNSUPPORTED 


mov 


ah. RS UNSUPPORTED 
iret 


pgid_driver endp 


age 
;@eeFUNCTION HEADE Na tikaewubwas van deans sacdheseueakwedadtcconceesswaatlens 
NAME: PGID_ISR 
| FUNCTIONAL DESCRIPTION: 


OWWDODHONONOHOWOUONO 
PPP RWWOWWWYW 


OWWWOWOOWONUNHNNWUNUOHO 
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; A graphics input device (GID) physical event has occurred which 
5 caused an P ISR request. If the event was a button press. then 
6 the D STATE and D_TRANSITION fields will be adjusted and the parent 
7 driver will be called immediately 
8 If a the event was a movement. this function will update the 
9 absolute position field if the device 1s a relative device or wiil 
0 update the relative position field if it's an absolute device Tt 
1 . will then call the PARENT driver to handle the movement event 
2 RRRARRRAARARARAAARARRAARAARRARRARARAAAREAR 
3 NOTE: The PGID driver takes HP-HIL ‘Y° axis data and translates 
4 ‘ it into INDUSTRY-STANDARD gad data {flips the Y axis) 
945 : AP-HIL has positive Y' in the upward direction. while 
946 : INDUSTRY-ST is downward 
947 bala ete ae ee ad ies edt alk Sade ie ah aa i alee Re 
949 . PARAMETERS 
51 ; ; ; ON ENTRY. 
nee : AH = F_ISR 
953 : OH = D_ TYPE 
954 ; OL = SOURCE Vector Index 
955 : DS 0 = Pointer to Physical device header and describe record 
956 . For Button Event (Keycode Event Record) (O_TYPE = T_KC_BUTTON) 
957 : BX = Button transition information 
958 ‘ bits 0 6 buttons 
959 ; bits 7° C up transition 
‘ 1 down transition 
961 . For Movement Event (GID Event Record. O TYPE = T RELO8. T_RELIE6, 
962 ‘ T_ABSO8. or T pES16) 
963 ; BX = AXIS-O (X) Movement in RAW data form (SIGN EXTENDED. 1f necessary 
964 \ CX = AXIS-1 (Y¥) Movement in RAW data form {SIGN EXTENDED, if necessary 
966 ; ON EXIT: 
967 : AH = Return Code (SET BY PARENT Driver) 
8 
9 REGISTERS ALTERED. ax bx cx 
0 
1 DEFINITION MODIFICATION HISTORY 
2 
3 VERSION: 
4 
5 DESCRIPTION OF CHANGES 
: ETTTTITTLILITTITTITTTT TTT TTT Ti TiTrrrerrrrrrrrrererrrrree eee eee 
8 page 
3 0414 pgid_isr proc near 
: See if this was a button event 
3 0414 80 FE O09 cmp dh. T_KC BUTTON . D_TYPE * T_KC_ BUTTON ? 
: 0417 74 57 je short button _isr . adjust DO_STATE & D_TRANSITION 
6 wt ern ree ee eee ee ee ee ee eee ee eee ee 
7 A movement occurred If this was an absolute device 
8 that moved. then adjust the relative location field in the describe record 
9 If it was a relative device, then adjust the absolute location field 
0 in_the describe record 
: BX,.CX have X.Y movement respectively 
3 0419 movement is¢ 
4 0419 80 FE 40 cmp dh. T RELOS . relative 8 bit movement 
5 O41C 74 3E je short rel move 
6 O41— 80 FE 41 cmp dh. Tv RELIE . relative 16 bit movement 
7 0421 74 39 je short rel move 
8 0423 80 FE 42 cmp dh. T ABSOS . absolute 8 bit movement 
9 0426 74 08 je short abs move 
00 0428 80 FE 43 cmp dh. T _ ABS16 . absolute 16 bit movement 
01 0428 74 03 je short abs move: 
02 
0 
bee If none of the sbove devices. then this is a bad input device 
006 0420 B4 FE ; mov ah. RS FAIL . return RS FAIL 
007 O42F C3 : ret . return to main driver 
08 page 
og , SS Beevssseesesessanensessaa 
10 Absolute movement 
Pe eee ee eee ee ee eee eee 
12 We must invert the Y axis to put into INDUSTRY STANDARD coordinate space 
13 Must convert “Y° coordinate such that negative movement is upward (opposite 
14 of HP-HIL definition 
15 -- Set BX.CX (x.y ABSOLUTE movement) for event record when done. then pass 
: event record to parent driver 
1 
18 {BX} is ‘X° HP-HIL coordinate 
19 . (CX) ds cy’ { ABS_Y(std) = D_SIZE_Y - ABS Y(hphil) } 
20 , SBSeussevsesseassesseneusen 
21 0430 abs move. 
22 0430 87 1E 0014 xchg ox.ds 0 ABS X ; Save new x position 
23 0434 28 1€ 0014 gud bx.ds D_ABS X , (OLD - NEW) 
24 0438 F7 OB neg bx . Relative move = (NEW - OLD) 
25 O43A 89 1E 0018 mov ds DO _REL_X. bx , Save new «x relative 
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F-46 


O43E 
0442 
0444 
0448 
044C 
O44e 


0452 
0456 
0454 


O45SC 
045C 
0460 
0462 


0466 
046A 


O46E 


C480 
0480 
O48F 
0493 
9495 
0496 





8B 1E 0012 mov bx.ds.D_SIZE_Y , "YY? Limit 
2B 09 sub be.cx : invert the axis: bx = (LIMIT - y) 
87 1E& OO16 xchg bx.ds D_ABS Y . New ABS Y 
28 1€ OO16 sub bx ds D_ABS Y ; {OLD - NEW) 
F7 OB : : . neg bx ; Relative move = rag - OLD) 
89 OF 0018 mov ds:0 REL _X cx : save new Y relative 
GET the X.Y absolute coordinates for the event record 
8B 1E 0014 mov bx.ds D_ABS X 
8B OE 0016 mov cx.ds D ABS Y 
EB 31 jmp short give fo_parent , ok to pass event to parent 
page 
[RRB ERESEKEESSERTERESTSEESESTS 
, Relative movement 
‘ We must invert the Y axis to put into INDUSTRY STANDARD coordinate space. 
; Must convert ‘Y' coordinate such that negative movement is upward (opposite 
' of HP-HIL definition. ) 
> s+ Set BX.CX (x.y RELATIVE movement) for event record when done, then pass 
event record to parent driver. 
_ (BX) is 'X' HP-HIL coordinate. 
» {CX) ta 'Y¥'  ( REL_¥f std) = -REL_Y¥(nphil) } 
_ SB ERRBRRSSETARST TS HSRTEHR EAR 
re} move: 
89 1£ 0018 mov ds D_REL_X,bx , gave new rel. move (X 
F7 09 ; neg cx ; CONVERT TO INDUSTRY STD. SPACE 
89 OF OOLA mov ds D_REL_Y.cx , Save new rel. move (Y) 
O1 1€ 0014 add ds :D_ABS X,bx - add new X relative movement 
O1 OE 0016 add ds D ABS Y.cx - add new Y relative movement 
" BX.CX atill contain X.Y relative movement information for the event record 
€B 1D ; jmp short give to_parent : ok to pass event to parent 
page 
Button Press/Release ISR 
Adjust the D_ TRANSITION and D_STATE fields of the physical device's 
Gescribe record 
Assuming 1 Only one button can make a transition at a time 
2 The button aa either goes up or down, not both 
3. No strings of buttons are sent (CX register avarlable). 
BL is number of button that changed 
bit 7 is the up/down (1/0) flag 
UP_DOWN BIT equ 100000008 , bit 7 is up (1), down(0) bit 
button isr 
: Convert button number to bit mask corresponding 
to the changed button 
8A CB mov el bl et button @ keycode in CL for ahift 
80 El 7F and ec} .011121118 eep button @, get rid of up/down flag 
BO 0} mov ai ,000000018 , put k’ in bat of al 
D2 £0 shi al.cl set appropriate button bit mask 
A2 Q00C mov ds D_TRANSITION, al - note which button changed 
F6 C3 80 test b1l.UP DOWN BIT , [bit 7] Was it UP = 1 or down = 0 
74 06 jz short button down 
button up. 
08 06 0000 or ds D_STATE al : get the button = 1 (up) 
EB 06 jmp ahort give _to parent : ok to pass event to parent 
button down 
F6 DO not al . invert for clearing the bit 
20 06 O00D and da Ob STATE al . clear the button to 0 (down) 
’ fall through to GIVE TO PARENT code -- ok to pass event to parent now 
jmp give to parent (COMMENTED OUT -- jump not necessary) 
page 
ok to pass event to parent now 
Call PARENT driver to handle the ISR 
NOTE HPHIL driver has already adjusted D SOURCE field, HPHIL_ID and other 
relevant HPHIL info before passing the event up to here. 
give to_parent 
B4 00 mov ah.F ISR : tell parent. ISR function 
8B 2€ OODA mov bp ds DH V PARENT > parent's vector 
CD 6F INT HP ENTRY 
C3 ret - return to main driver 
pgid_isr endp 


subttl) PGIO SYSTEM function 
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.,#saFUNCTION HEADER nae Wes Ses Sasa ea Senses hier aneeeeowrecnreresesasaneees 


NAME: PGID_SYSTEM 
FUNCTIONAL DESCRIPTION: 

This function supports the HP SYSTEM subfunctions requested of 
the PGID driver The subfunction is checked to make sure that it 
is in the appropriate range. 

PARAMETERS 
ON ENTRY: 
AH = F SYSTEM 
AL = SYSTEM subfunction code 


F_SYSTEM Subfunctions (in hex} 
= wee ee not included are UNSUPPORTED} 


SF_START 
SF_REPORT STATE 
SF_VERSIORN_DESC 
ON EXIT: 
See individual system subfunctions 
RS_UNSUPPORTED will be returned if 
REGISTERS PRESERVED: 
DEFINITION MODIFICATION HISTORY 
VERSION: 


DESCRIPTION OF CHANGES: 


for values returned. 
th 


e subfunction is out of range. 


’ 
SPSS eset asesen sass se SETA sEKASCEK SSE BETST ESSA UTS ES EKER EH ESSE sE SC EsEEEES 


page 
pgid_ system proc near 
cmp al MAX PGIO_SYS_FN check bounds 
ja short pgid_ sys bad out of range ? 
xehg Nga save bx, set bpesubfunction code (al) 
mov bi,al 
xor bh, bh 
xchg bp.bx 
jmp cs:word ptr pgid_sys_case[dp} 
pgid_sys_bad: 
mov ah, RS UNSUPPORTED bad subfunction code 
ret return to main driver 


pgid_sys_ case: 


dw word ptr pgid_init SF_INIT 

dw word ptr pgid_ start SF START 

dw word ptr pgid state : SFTREPORT STATE 

dw word ptr pois _versien : SF_VERSION_DESC 
MAX_PGID_SYS_FN equ byte ptr ($3 - pgid_sys_case - 2) ; max supported sys fn. 
pgid_system endp 

subttl PGID_INIT System Subfunction 


age 
,seaFUNCTION HEADE Rew cnnccncnccsccccussancanasccccacccssussncnsasseccace 


NAME : PGIO_INIT 
FUNCTIONAL DESCRIPTION. 


System subfunction SF_INIT -- initialize the Breer device 
header and describe record IT IS ASSUMED THAT TH PHIL DRIVER HAS 
INITIALIZED ALL APPROPRIATE INFO ALREADY... All position and button 
data is zeroed out, and relevant HPHIL info is already filled in. 
Only must set default button states {all off (#1)). 

PARAMETERS 
ON ENTRY: 


AH = F_SYSTEM 
AL © SF_INIT 


ON EXIT: 
AH = Return status (RS SUCCESSFUL} 


REGISTERS ALTERED: ax 
DEFINITION MODIFICATION HISTORY 
VERSION: 
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1211 ‘ 

1212 DESCRIPTION OF CHANGES. 

1213 ; 

1214 ei oe eee hee OO ee rere ee eae ee eS 
1215 0484 Ti in roc near 

ee « OOFF art - BUTTON _STAT equ OFFh . all buttons open 
121 

ioe 04B4 C6& 06 OOOD FF mov ds -D_STATE ,INIT_BUTTON STATE ; all off 

1220 04B9 84 00 mov ah, RS SUCCESSFUL; successful initialization 

1221 O4BB C3 ret > return to main driver 

1222 04BC pgid_init et ¢ 

1223 subttl PGIO_START System Subfunction 

1224 e 

1225 ,@2eFUNCTION EAD EH La eee Fk cde Due oh oseeadinee ce dsdawas cama weekewasnen’ 
1226 

1227 NAME - PGIO_START 

1228 

ae FUNCTIONAL DESCRIPTION: 

123 

122) System subfunction SF START -- start the driver. This does nothing 
1232 but return with RS SUCCESSFUL. 

1233 

1234 PARAMETERS 

1235 

1236 ON ENTRY: 

1237 AH = F_ SYSTEM 

1238 AL = SF_START 

1239 

1240 ON EXIT 

1241 AH « return status (RS SUCCESSFUL) 

1242 

1243 REGISTERS ALTERED: ah 

1244 

1245 DEFINITION MODIFICATION HISTORY 

1286 ; 

1247 VERSION: 

1248 

1249 DESCRIPTION OF CHANGES: 

eee WITITTITITITITITITTLIT LT 
took 04BC pgid_start proc near 

1254 04BC 84 00 mov ah, RS SUCCESSFUL; successful start up 

1255 O4BE C3 ret . return to main driver 

1256 O48F pgid_start ange 

i257 subttl PGID_STATE System Subfunction 

1258 : age 

1259 : sseFUNCTION HEADER cuwcdedeSecudee sb sewevacucbesececonessedtewseseecaces 
1260 . 

ioeD » NAME. PGID_ STATE 

eet ’ FUNCTIONAL DESCRIPTION 

1265 : System subfunction PGIO_REPORT_STYATE -- report the state of this 
tees > driver {NOT SUPPORTED) 

1268 PARAMETERS 

1269 

1270 ON ENTRY: 

1271 AH = F_ SYSTEM 

1272 AL = SF_REPORT STATE 

1273 

1274 ON EXIT: 

ious AH = return status (RS UNSUPPORTED) 

ae REGISTERS ALTERED: ah, dx 

a: OEFINITION MOOIFICATION HISTORY 

1281 VERSION 

1282 

a DESCRIPTION OF CHANGES: 

1285 , SR SSTSSSSSHSSSSSTESTSSSHSS SST SSSHSSSHSSAKCSSSHSSSHSTSSSSeKSSSHESBBSSSH SETS 
1286 O4BF pgid_state proc near 

1287 O4BF 84 02 mov ah, RS UNSUPPORTED . function not supported 
1288 04C1 C3 ret . return to main driver 

1289 04C2 pgid_state bathed 

1290 subttl PGID_VERSION System Subfunction 

1291 

1292 .=a2FUNCTION PURER cen ccudeycasataatedcaee seus venevedeedscuenesesrasees 
1293 

rene NAME - PGID_VERSION 

1296 FUNCTIONAL DESCRIPTION 

1297 System subfunction SF VERSION DESC -- Report the version 

ree number of the driver (Use standard system version number) 

1300 PARAMETERS 

1301 : 

1302 ON ENTRY 

1303 AH = F_ SYSTEM 

1304 


AL = SF VERSION DESC 
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Structures and 


SIDI. 
DESCRIBE 

D_ SOURC 

DUHPHIL 


DDESC_MASK. 


D010 MA 


D~XDESC_ MASK 


DTMAX_A 
“CLASS 
~PROMP 

RESER 


£ 
@ 
x» 
m 


STATE 
ESOL 


A bahia deat atc iat wate 
rid 


900000 
PUBDERNUND 
OFPAM MD Orte 


STR. 
MAP_CAL 
SUBADD 


O4C2 
04cz 
O4c4 
04C7 
O4CA 
04CB 
04CC 
0400 
04D1 


0401 


04D1 


oo 
Kin 
me 
Pe 


Es 2. 
IO 


Sk. 
XIs 


TS. 
VED 


BURST LEN. 
TRDTREG |. 

TRANSITION 
UTION 


xX. 


L 


records: 


Nam 6 


OWwWo 
Ono 


3£ 0099 R 


40 


ow 


00 


ON EXIT 
AH = RS_ SUCCESSFUL 
fothers) see hp_system_version function. 


REGISTERS ALTERED ah.es.di 
DEFINITION MODIFICATION HISTORY 
VERSION: 
DESCRIPTION OF CHANGES: 


pgid_version proc near 
mov ah, RS SUCCESSFUL 
mov bx, 5225H 
mov cx, VERSION_LEN 
push cs 
op es 
oa di, cs: VERSION LAB 
ret > return to PGID main driver 
pgid_ version endp ; 


RERAAAAAARRARARRARRARRRARRAARRAAERRARRARRARARARARAAARRAAARAARAARR AAR ARERR 


END OF DRIVER 
-LOCAL STACK USED DURING INITIALIZATION 
DB 64 DUP (0) 


STACK_TOP- 

CODE ENDS 
END 

Width # fields 

Shift 


Width Mask Initial 


OOOF 0001 8000 0000 
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PSHARE 0003 0001 0008 0000 
CSHARE 0002 0001 0004 oco0 
ROM ee 9001 9901 9002 0000 

2 : 3 oot 

HP HEADER 0010 0009 moe 
DH_ATR ; ai eee 0000 
DH NAME INDEX, . _ _ 0002 
DH7V DEFAULT . _ 0004 
DH-P CLASS. 0008 
DH C CLASS | fae 0008 
DH” V~PARENT ute e fA OOOA 
DH V “CHILD ee 8 See oo0c 
DH MAJOR OOOE 
DH "MINOR OOOF 

REQ READER 0017 OO0A 
RA LENGTH 0000 
RH UNIT CODE 0001 
RH CMO CODE 0002 
PH STATUS. 0003 
RH RESERVED 0005 
RH UNIT CNT 000D 
RH END OFF OOOE 
RH-END SEG | ’ . & 0010 
RH BPB ; 0012 
RH DRIV 0016 

STATUS a 0010 0005 
ERROR ; OGOF 0001 8000 occo 
z 000A 0005 7COG 0000 
BUSY 0009 0001 0200 2000 
DONE ; . 0008 0001 0100 0000 
ERR TYPE 0000 0008 OOFF 9000 


Segments and Groups 


Name Size Align Combine Class 
CODE o511 PARA PUBLIC ‘CODE’ 
Symbols 

Name Type Value Attr. 
ABS MOVE L NEAR 0430 CODE 
BAD_CMO L NEAR 0292 CODE 
BISR2 L NEAR O1FA CODE 
BUTTON DOWN L NEAR 0487 CODE 
BUTTON ISR L NEAR 90470 CODE 
BUTTON TAB L BYTE O1F7 CODE 
BUTTON UP L NEAR 048] CODE 
CHECK F SYSTEM L NEAR 0408 CODE 
CMD TABLE L WORD 0152 CODE 
COM MSG L BYTE O0C1L CODE 
COM NUMBER L WORD 0128 CODE 
Cr Number OO00D 
DEBUG Alias TRUE 
CEV ATTR Number AC18 
DEV DESCRIBE L 0020 0030 CODE 
DEV DRIVER F PROC 0900 COOE Length #O3FF 
DEV HEADER ; L 0010 0920 CODE 
DEV_INTERRUPT F PROC 0270 CODE Length #=O18F 
DEV STRATEGY F PROC 0265 CODE Length =000B 
OOS ENTRY Number C021 
DRIVER ATTR tL WORD 0004 CODE 
DRIVER NAME L BYTE QUOA CODE 
ENO OF ORIVER L NEAR O4D1 CODE 
EXIT . L NEAR O29E CODE 
FALSE Number 0000 
FRAME COUNT t WORD OL3A CODE 
F INQUIRE ENTRY : Number (COOC 
FINS BASEHPVT Number 0QQ004 
FINS XCHGFREE Number OOOA 
FIO CONTROL Number 0004 
F ISR Number 0000 
F SYSTEM Number 0002 
GIVE TOC PARENT L NEAR 0480 CODE 
HPHICL ABD L BYTE 0150 CODE 
HPHIL TABLE : lL BYTE 0142 CODE Length *000EF 
HP ENTRY . Number OO6F 
1c 1 L NEAR 02C8 CODE 
TC 10 L NEAR 0363 CODE 
IC 2 { NEAR O2DA CODE 
i€- 3 i NEAR O2EF CODE 
Ic 4 L NEAR O2F6 CODE 
IC_4A L NEAR 0314 CODE 
INIT 3 ; L NEAR O37C CODE 
INIT BUTTON STATE. Number GOFF 
INIT COGE . L NEAR O2A? CODE 
INIT EXIT L NEAR O3CB CODE 
INIT NO PORT re L NEAR 0382 CODE 
INIT NO VECTOR . : L NEAR O3A9 CODE 
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INIT_OK 
INT ENT 
INT TABLE 
LAST SYNCH 
LF 

MASK TABLE 


MAX PGID SYS FN 


MBUTTON 
MBUTTON DOWN 
MBUTTON ISR 
MBUTTON UP 
MNEXT BUTTON 
MOUSE INT 
MOVEMENT ISR 
MSD BAD LENGTH 
MSO BLD BPB 
MSD ‘CRC ERROR 
MSD DEV CLOSE 
MSO DEV OPEN 
MSD 
MSD 
MSD 


INIT 
INPUT 
MSO_IN FLUSH 
MSD IN NOWAIT 
MSO_IN STATUS 


MSD_IOCTL_IN | 
MSD_IOCTL_OUT. 
MSD MEDIA CHK. 
MSD_NOT ROY. 
MSD OUTPUT 

MSD OUT FLUSH 
MSD _OUT_STATUS 


MSO OUT VERIFY 
MSD PAPER OUT. 
MSO_READ FAULT 
MSD_REM MEDIA 


MSD_SEC NOT FOUND. 


MSO_SEEK_ ERROR 


MSO_UNKNOWN_ CMO 
MSD UNKNOWN MEDIA 
MSD “UNKNOWN UNIT 
MSD WRITE FAULT 


MSO WRITE PROT 
MSE_NUM BUTTON 
MSIL. 
MSI~2 

MSI73 

MSIU4. 

MSI7S 

NO_ PORT MSG 
NO VECTOR 

OK ~MSG 

PGID DRIVER 
PGID_ INIT 

PGID ISR 

PGID_ 

PGID START 
PGID STATE . 
PGID SYSTEM 
PGID™SYS_BAD 
PGID_ SYS CASE 
PGID_VECT_NUM 
PGID_VERSTON 
PRINT STR 

REL MOVE 

REQ HOR OFF 
REQ HOR SEG 
RH CMD_LINE 

RS DONE 

RS FAIL 

RS NO VECTOR 
RS_ SUCCESSFUL 
RS UNSUPPORTED 


SF MOUSE OVERRIDE. 


SIGN ON MSG 
STACK PTR 
STACK SEG 
STACK” TOP 
STRAT ENT 
TEMP BUFFER. 


TRUE 

T ABSO8 
TABS 16 
T"KC_BUTTON 
TT RELOB 
T7RELI16 
UNSUPPORT_CMD 
UP_DOWN 8TIT 
VERSION LAB. 
VERSION LEN 
V_DOLITTLE 
Vv” LHPMOUSE 


GEN_FATLURE 


OPCODE BAD 


L NEAR 
4 WORD 
L WORD 
L BYTE 
Number 
WORD 
BYTE 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 


Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
Number 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
BYTE 
BYTE 
BYTE 
PROC 
PROC 
PROC 
NEAR 
PROC 
PROC 
PROC 
NEAR 
NEAR 
BYTE 
PROC 


[lk eee eel ae cael el el Dd 


Zeer zzZ22rz222rrerr4er ree 


Number 


COOE 


CODE 
CODE 


CODE 


CODE 
CODE 
CODE 
CODE 
CODE 
CODE 


CODE 


CODE 
CODE 


Globa 
Lengt 
Lengt 


Lengt 
Lengt 
t 


1 
h 
h 
h 
h 
Length 


Length 


Length 


re he 20015 
*000 
#0082 
#0003 


#0003 
“OO1E 


=000F 


=0005 
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MSSINPUTS oe ap <a cee eer oy ae Number 
VUSYSTEM 2 7 ww we, aio8: Number 


40380 Bytes free 


oo 
Qo 
ed 
NP 


Warning Severe 
Errors Errors 
0 0 


A. : betes et 2 Pisin gh 2 2 
ABS MOVE : 999 1 


10218 
ATTR. .. weds o D3 have 76% 


NO 
Wr 


B oo, ks 

BAD CMD . 613 
BISR2 4c nae 498 
BUSY ee cat Shs She 928 
BUTTON DOWN... 1093 
BUTTON ISR 984 
BUTTON TAB . 496 
BUTTON UP 10948 


CHECK_F_SYSTEM.. 4 os 907 
CLK. : io : 
CMO_TABLE. 3 
CODE fy yas ae’ tee fs Rama ery ce GEDA 2 
COM MSG. 32 ; a site 8 
Se eee a ee 3 
1 
2 
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332 338 338 348 349 354 673 


WO ND wo 
NWOUIH 
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76 
87 
53 
. 38 
COM~NUMBER 60 
CR ure 4s 
CSHARE 03 
DEBUG. wt 2 ue 50 
DESCRIBE oa. _ 66 197 
DEV 76 

03 

73 

84 

58 

74 


OEVCFG 
OEV_ATTR 274 
866 


6008 
$928 


DEV_DE SCRIBE 
DEV7DRIVER 


DEV-HEADER __. 
DEV INTERRUPT. 
DEV STRATEGY 
OH_ATR 
DH_C_CLASS 

DH MAJOR 

DH MINOR 
DH7NAME_INDEX. 
DHP_CLASS 


Woo 
oa 
au 


1 

2 

2 

2 

2 

2 

2 

2 

1 

1 

l 

1 

1 

1 

1 

avs 1 

DH-V~ PARENT. 1 
DONE oo.eee, a 

DOS ENTRY ee 

2 

1 
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INQUIRE ENTRY... 
INS _BASEHPVT 
INS_XCHGFREE 
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YSTEM 


~~ oF WN) O > Co HNNUIO 
Seseaceane eee8 


RMNNNANW 


pis rds 


F-52 Driver Writer’s Guide 


RS-232 Mouse Driver 


GIVE_TO_PARENT 


HP 
HPHIL ADD. 

HPHIL TABLE. 
HP_ATTR 

HP_ENTRY 
HP_HEADER 

IBM, 

C1. 

1C710. 

Ic72 | 

1C_3 | 

IC 4 | 

IC_4A. 

INTT 3 

INIT BUTTON STATE 
INIT_CODE 
INITTEXIT 
INIT_NO_PORT 

INIT NO~VECTOR 
INIT-OK. | ‘ 
INT_ENT. 

INT TABLE. 

IOCTL. _ . 


TSR. 
LAST_SYNCH 
LF ts 


MAP CALL . . 
MASK TABLE . 
MAX_PGID_SYS_FN. 
MBUTTON.. : 
MBUTTON_DOWN 
MBUTTON_ISR. 
MBUTTON UP . 
MNEXT BUTTON 
MOUSE INT... 
MOVEMENT ISR. 
MSO_BAD_CENGTH 
MSD BLO_BPB.. 
MSD_CRC_ERROR. 


MSD_GEN TPATLURE 
MSD_INIT 
MSD-INPUT 
MSO"IN FLUSH . 
MSD_ IN NOWAIT. 
MSD_IN STATUS. 
MSO-IOCTL_IN | 
MSD_IOCTL_OUT. 
MSD_MEDIA_CHK . 
MSO~NOT_RDY. 
MSO-OUTPUT | . 
MSO_OUT FLUSH. 
MSD~OUT~STATUS 
MSD” OUT_VERIFY 
MSD_PAPER OUT. 
MSD-READ FAULT 
MSOTREM MEDIA. 


MSD_SEC NOT FOUND. 


MSO_SEEK_ERROR . 
MSOD_UNKNOWN_CMO 


MSD~UNKNOWN” MEDIA. 


MSO UNKNOWN UNIT 
MSD_WRITE_ FAULT. 
MSD_WRITE PROT 
MSE_NUM_ cial 


NO_PORT_MSG. 
NO_VECTOR . 
NUL. 


OCREM. 
OK MSG 


PGID_DORIVER. 
PGIO Toe. : 


PGIO 
PGID GPCODE _BAD. 
PGID_ START . . 
PGID_STATE 
PGID_SYSTEM. 
PGIO_SYS_BAO . 
PGID_SYS_CASE. 
PGID_VECT_NUM. 
PGIO VERSTON 
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8376 
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9058 926 
1222 
1115 
1256 
1289 
1181 
1180 
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1327 


676 


Driver Writer's Guide 


F-53 


F-54 


RS-232 Mouse Driver 


PRINT_STR 
PSHARE 


REL_MOVE 
REQ HOR OFF 
REQ HDR SEG 
REQ HEADER 
RH_BPB 
RH-CMO CODE 
RH~CMD LINE 
RHORIV 
RH_END OFF 
RH_END_SEG 
RH LENGTH 
RH RESERVED 
RH STATUS 
RH7UNIT CNT 
RH UNIT CODE 
ROM 

RS_DONE 

RS FAIL 
RS”NO VECTOR 
RS” SUCCESSFUL 
RS UNSUPPORTED 


SF _MOUSE Seren tbe. 


SIGN_ON_MS 
SPEC 

STACK PTR 
STACK SEG 
STACK TOP. 
STATUS 
STDI 

STDO 

STR 

STRAT ENT. 
SUBADD 


TEMP BUFFER 
TRUE 


TYPE 


T ABSO8 
BS16 

“KC. BUTTON 

TRELOB 

TTRELI6 


UNSUPPORT_CMD 


TA 
TK 


UP_DOWN BIT 
VERSION LAB 


VERSION_LEN 
DOLITTLE 


220 Symbols 
$0960 Bytes Free 


Driver Writer's Guide 


Ww eo Ne 


Mww wr MIMI MPO PD 


~ mre NOWW ~ ow WWNWW Of~ COMAONNYOMNMNN sre WW SWOUDOAAMAMDODA AMM UN--- OO Ow 


fe} —-UINWWO co NO rOWWN WOR WhWADMM-wo~tMoaw WM ODWOWNDUIA NT OMNDOAWW Weo 
SSEeesvwe eee SHESSES CHES SHeeeexeeaeneecavevuavanun 


~ 
NNNNRWwH oO Pw NMRA w NNN 


eos senana & 


~ 
@ 
= 


920 


TUN wD oa 
fe) 
oO 


WN He MwWwODoM 
-O Neer OhW~ 


@o co ann 


o 
Nn 
a 


1006 


1220 
783 


807 
658 


646 
13408 


> 


WONANNW © NI GO Mmor--owo unt 


— 
SNRPaNW NH fBO RBPPOT CO 


= 
NUTRI MO WD Q aw MOunowo 


- 


818 825 
10538 

610 849 
627 631 
1254 1320 
$23 1169 
856 

461 542 
983 

996 

390 391 
1325 

808 844 
$71 779 


834 


1287 


544 


392 


548 


393 


394 


395 


396 


397 


398 


399 


400 


401 


Glossary 





ACK - Acknowledge. 


Adapter — A circuit board containing electronic circuitry that interfaces a peripheral to the system 
processor board. 


Adapter Card - See ADAPTER 


Alphanumeric Display Mode - One of the Video Display Adapter modes. When this mode is selected, data 
is displayed in character cells, organized in rows and columns on the screen. 


Application Programs ~ Software that performs application-specific tasks. Word processors, spreadsheets, 
and data bases are examples of application programs. 


Barcode Reader - An input device that is used to scan surfaces containing barcodes. The barcode reader 
converts barcodes into scancode data format, and transmits the scancodes to an input interface. 


Baud Rate - The rate a signal changes state. When used with relationship to RS-232 ports, it is 
synonymous with the data transfer rate, expressed in bits per second (BPS). 


BCD - Binary Coded Decimal. 


BIOS - Basic Input/Output System. The BIOS is the code module that contains the drivers that constitute 
the software interface between the hardware, and system software and application programs. 


Bootstrap - The process of initializing the system and loading system software after a reset. 

BPS - Bits per second. 

Bucket - A data structure used by the EX-BIOS string functions for alphanumeric string management. 
CALL SYSCALL - Issues an HP system call. This routine assumes that the EX-BIOS is enabled. When 

first called, this routine will patch the first instruction "JMP SHORT PATCH" to become "INT XXH" 


where XXH is the current HP interrupt number. 


Character Code - A word returned by the keyboard driver indicating a key stroke. The character code 
consists of a keyboard scancode, and either an Extended (OOH) or ASCII character. 


Checksum - An error-checking protocol used to verify the integrity of a block of data or code. Each byte 
or word in the block is summed, then added to a checksum byte. The block of data or code is presumed 
valid if this sum equals a predefined value, usually 0. 


Checksum Byte - A byte added to the sum of a block of code or data to produce a valid sum. 


Child Driver - A child driver is called by another driver when that driver is unable to perform a function 
requested of it. Child drivers perform lower level or more hardware-specific tasks than their calling 
drivers. 


Clipping - The process utilized when dealing with graphics coordinates outside of the logical coordinate 


space. The Input System clips coordinates so that they don’t exceed the boundaries of the logical 
coordinate space. 
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CMOS Memory - RAM memory on the Processor Board that is powered by both the system power supply 
and battery. When the system power is turned off, the contents of the RAM memory are preserved by the 
battery. 

Code Module - A group of related processor instructions. 

Code Segment (CS) - The segment address of the code module currently being executed. 

Compatibility Function Keys - The 10 function keys labeled F1-F10 on the keyboard. The HP Function 
keys (f1-f8) can be mapped to emulate their respective Compatibility Function keys (F1-F8). See also 
HP FUNCTION KEYS. 

Coprocessor - An add-on processor that works with the CPU (Central Processing Unit) found on the 
Processor PCA. The 80287 (Vectra ES), the 80387 (Vectra QS and RS), and the Weitek coprocessor 
(Vectra RS only) are examples of specialized coprocessors for floating point arithmetic. 

CRC - See CYCLIC REDUNDANCY CHECK CHARACTER. 

CS - See CODE SEGMENT. 

Cursor Control Keypad - The keypad containing the HP cursor control keys. 


Cylinder - A term used with multi-platter disc mechanisms, a cylinder is a group of sectors having the 
same track number on each of the platters. 


Cyclic Redundancy Check Character - Character used as a redundant character for error detection in 
various modified cyclic codes. 


Daisy Chain - A method of linking devices together in a serial configuration. Input devices on the 
HP-HIL loop are connected in a daisy chain. 


DASD - Direct Access Standard Device. 
Data Segment (DS) - The segment address of the data currently being accessed. 
Data Structures - A related group of data fields. 


Describe Record - A data structure utilized by the Input System which contains information 
characterizing an input event. 


Device - A physical piece of hardware, e.g., a Touchscreen, mouse, keyboard, dot matrix printer, 
ThinkJet, or LaserJet. 


Disc Partitions - A group of cylinders within a hard disc volume allocated to a specified operating system, 
and its associated programs and data. 


Disc Volumes - A group of cylinders comprising a logical disc. The optional 20 Mbyte hard disc contains 
a single volume. Optional hard discs greater than 32 Mbytes in size must be divided into two or more 
volumes of up to 32 Mbytes each. 

Divide By Zero Interrupt - The CPU executes this interrupt any time a divide-by-zero operation is 
attempted. The vector to the service routine for this interrupt must be stored in memory locations 
0000:0000H-0000:000 3H. 


DMA - Direct Memory Access. 
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DOS - Disc Operating System. 


DOS Installable Device Driver - A device driver headed to be dynamically installed by DOS. DOS 
installable device drivers may be used to add EX-BIOS drivers to the system. 


Driver - Code that interfaces to either a physical device or another driver. 


Driver Header - A data structure contained in the data area of each EX-BIOS driver. The driver header 
contains data fields that specify the attributes, mapping, and other parameters of the driver. 


DS - Driver Segment. 

EGA - Enhanced Graphics Adapter. 
EOI - End Of Interrupt. 

EOT - End Of Track. 


EX-BIOS - Extended BIOS. A set of HP proprietary drivers that provide support for various system 
features. 


Extra Segment (ES) - The segment address of the extra data segment currently being accessed. 
FAT - File Allocation Table. 
FDC - Flexible Disc Controller. 


Functions - Code modules within a driver that perform specific tasks. Individual driver functions are 
selected when a driver is called. 


Function Keys - The keys (F1-F12) on the Vectra Enhanced keyboard. See also HP FUNCTION KEYS, 
and COMPATIBILITY FUNCTION KEYS. 


GDT - Global Descriptor Table. 
GID - see GRAPHIC INPUT DEVICE. 


Graphic Display Mode - A video display adapter mode in which all positions on the screen are addressable 
as pixels. 


Graphic Input Device - An input device that generates positional and/or button state data. A mouse, 
tablet, and touchscreen are examples of graphic input devices. 


Graphics Sprite - See SPRITE. 
Hardware Interrupts ~ Requests for interrupt service generated by the hardware components. 
Head - The magnetic device that reads and writes data from a disc drive. Disc drives have a head for 
each recording surface in the mechanism. A flexible disc has two heads, while a hard disc head count can 
vary depending on the drive being used. The optional 20MB disc has two platters and four heads. 
Hexadecimal - Numbers expressed in base 16. Hexadecimal notation is used throughout this manual to 


represent binary data. Hexadecimal digits are represented with the numbers 0-9 and letters A-F. The 
hexadecimal numbers are indicated with an uppercase ’H’ as their last character (i.e., 17H). 
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HP Extensions - Additional functions added to industry standard drivers that support EX-BIOS features 
and/or provide additional flexibility in programming industry standard system capabilities. 


HP Function Keys - The function keys labeled f1-f8 on the Vectra Keyboard /DIN. These keys can be 
mapped to return their own scancode, or they may emulate their respective Compatibility Function keys 
(F1-F8). See also COMPATIBILITY FUNCTION KEYS. 


HP Global Data Area - A data structure located in the EX-BIOS Data Area containing variables common 
to two or more EX-BIOS drivers. In addition, the stack used by the EX-BIOS drivers is located here. 


HP_ENTRY_ CODE - The code module that dispatches the EX-BIOS interrupt (default 6FH) to th 
selected driver. ; 


HP_ENTRY - The symbolic reference for the EX-BIOS interrupt (default 6FH). Always use a "CALL 
SYSCALL" routine to call the EX-BIOS drivers. 


HP-HIL Controller - The hardware that provides the electrical interface to the HP-HIL link and 
supervises the communication protocol. 


HP-HIL Link - The electrical interface and communication protocol utilized to connect HP-HIL input 
devices. 


HP-HIL Major Address - The primary address of an HP-HIL device. This is typically the link address of 
the device. 


HP-HIL Minor Address - The secondary address of an HP-HIL device. 


HP-HIL Universal Address - Used to broadcast commands to all HP-HIL devices. The Universal Address 
is implemented as Address 0 in the HP-HIL protocol. 


HP_VECTOR_TABLE - A data structure containing the IP, CS, and DS of all EX-BIOS drivers. This 
data structure is utilized by the HP_ENTRY_ CODE to branch to the selected EX-BIOS driver. 


Input System - A set of EX-BIOS drivers that service the input devices. The Input System supports the | 
HP Mouse, HP Touchscreen, HP Tablet and other HP-HIL input devices. It can be expanded to encompass 
non-HP-HIL input devices. 


Instruction Pointer - (IP) The offset from the base of the code segment of the next instruction to be 
executed. 


Interleave - The number of physical sectors on a disc drive skipped when reading consecutive logical 
sectors on the same track. See also STAGGER. 


Interrupt Service Routine - A code module, and its associated data structure(s) that responds to a 
hardware interrupt. 


Interrupt Vector - A data structure used by the CPU to branch to a service routine or an interrupt. 
Interrupt vectors are located in the first 1024 bytes of system memory. Each interrupt vector occupies 2 
words of memory and contains the IP and CS of the interrupt service routine. 

IP - Instruction Pointer. 


IRET ~ Interrupt Return. 


IRQ - Interrupt Request. 
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IS - Industry Standard. Also see INDUSTRY STANDARD. 


ISR Event Record - A data structure used by the Input System which contains information characterizing 
an input event. 


KB - Kilobytes. 1024 bytes. 

Keyboard - The physical keyboard. 

Keyboard Controller (8042) - The 8042 keyboard controller. The 8042 provides industry standard 
keyboard compatibility and serves as a buffer between the STD-BIOS keyboard drivers and the Input 
System. 

Keyboard Modifier - One of the special keyboard keys that modifies the interpretation of the other keys. 
The keyboard modifiers are the <CTRL>, <Alt>, <Shift>, <Caps lock>, <Num lock>, and <Scroll 
Lock> keys. 


LED Mode Indicators - The LEDs located on the keyboard that indicate the state of the CAPS LOCK, 
NUM LOCK, and SCROLL LOCK keyboard modifiers. 


Logical Driver - A driver responsible for interfacing with the Operating System or application. 
Logical Keyboard - A set of drivers within the Input System that service the physical keyboard. 
MB - MegaByte. 1,048,576 bytes. 

MASM - Microsoft Macro Assember. 


MICKIES - The number of physical coordinates per inch reported by a mouse or other relative graphics 
input device (GID). 


Mouse - A graphics input device (GID) device that reports relative motion coordinates based on its 
motion. A mouse will also report the state of its buttons. 


MS-DOS - Microsoft Disc Operating System. See DOS. 

Multi-Tasking - The ability of a CPU to perform multiple jobs or tasks simultaneously. Multi-tasking is 
accomplished by dividing CPU execution time between the different tasks. If this task-switching is 
performed quickly enough, the illusion of simultaneous execution occurs. 


Numeric Keypad - The keypad containing numeric and modifier keys. 


NMI - Non-Maskable Interrupt. This is a CPU interrupt line used to report system error conditions. This 
interrupt is mapped by the CPU to Interrupt vector 02H. 


NOP - No operation. A no-operation instruction causing the computer to do nothing except go to the 
next instruction. 


OBF - Output buffer full. 


Operating System - The system software that provides access to system resources for application programs. 
The operating system manages input and output, data and program files, and system memory. 


Original Vectra PC - The precursor to the Vectra ES, QS, and RS series of computers. The original 
Vectra PC simply had "Vectra" in red letters on its nameplate. 
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Palette - The set of all possible colors the Video Display Adapter can produce. The Multimode Video 
Display Adapter has a palette of 16 colors. 


Parallel Port - An I/O port that transmits and receives data a byte at a time. The parallel ports are 
typically used to interface to printers. 


Parent Driver - A parent driver is called by another driver when the second is unable to perform a 
function requested of it. Parent drivers perform higher level or more system software oriented tasks than 
their calling drivers. 

Physical Driver - A driver responsible for interfacing with the physical hardware. 


Pixel - A dot on the screen in the graphics modes. 


Polling - The process of periodically determining the status of a device. Polling is used to determine if 
peripheral devices have data or are ready to accept data in non-interrupt driven systems. 


POST - Power-On Self Test. The POST process is executed each time the system is powered on. 


Processor Interrupts - Interrupts generated by the CPU processor in response to error conditions or 
processor exceptions. 


Protected Mode - One of the two modes that the CPU can operate in. The Protected mode provides 
virtual memory addressing, in-chip memory management and protection, and task switching to support 
multi-user, multi-tasking system software. 


RAM BIOS - The interface between DOS and the ROM BIOS. It is dynamically loaded at system boot 
with DOS. 


Real Mode ~ One of the two modes that the CPU can operate in. The Real mode provides compatibility 
with the 8086 family of microprocessors. 


Real-Time Clock - A clock circuit that maintains the correct time whether the system is on or off. The 
real-time clock is powered by both the system power supply and battery. When the system power is 
turned off, the clock continues to operate from the battery. 


Return Status Code - A code returned by the EX-BIOS drivers that indicates the status of the function 
requested. 


ROM BIOS - The set of EX-BIOS and STD-BIOS drivers. These code modules are contained in the base 
ROM modules on the Processor PCA. 


ROM Module - Code and/or data stored in an EPROM or ROM. 


RS-232C - An Electronic Industries Association (EIA) standard for a serial data transmission interface. 
Often used as a synonym for serial when referring to system ports. 


RTC - Real-Time Clock. 

Scaling ~ The process of adjusting physical graphics coordinates to fit in a proportionately larger or 
smaller logical space. The Input System scales the coordinates received from a tablet to fit into its logical 
space. 


Scancodes - Codes returned by the physical keyboard to indicate key makes and breaks. 


SDLC - Synchronous Data Link Control. 


6 Glossary 


IS - Industry Standard. Also se INDUSTRY STANDARD. 


ISR Event Record - A data structure used by the Input System which contains information characterizing 
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Keyboard Modifier - One of the special keyboard keys that modifies the interpretation of the other keys. 
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Lock> keys. . 
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NUM LOCK, and SCROLL LOCK keyboard modifiers. 
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Mouse ~ A graphics input device (GID) device that reports relative motion coordinates based on its 
motion. A mouse will also report the state of its buttons. 
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accomplished by dividing CPU execution time between the different tasks. If this task-switching 18 
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NMI ~ Non-Maskable Interrupt. This is a CPU interrupt line used to report system error conditions. This 
interrupt is mapped by the CPU to Interrupt vector 02H. 


NOP - No operation. A no-operation instruction causing the computer to do nothing except go to the 
next instruction. 
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Operating System ~- The system software that provides access to system resources for application programs. 
The operating system manages input and output, data and program files, and system memory. 


Original Vectra PC - The precursor to the Vectra ES and RS series of computers. The original Vectra PC 
simply had "Vectra" in red letters on its nameplate. 
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Palette - The set of all possible colors the Video Display Adapter can produce. The Multimode Video 
Display Adapter has a palette of 16 colors. : : _ , | 


Parallel Port - An I/O port that transmits and receives data a byte at a time. The parallel ports are 
typically used to interface to printers. . 


Parent Driver ~ A parent driver is called by another driver when the second is unable to perform a 
function requested of it. Parent drivers perform higher level or more system software oriented tasks than 
their calling drivers. 

Physical Driver - A driver responsible for interfacing with the physical hardware. 
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Polling - The process of periodically determining the status of a device. Polling is used to determine if 
peripheral devices have data or are ready to accept data in non-interrupt driven systems. 


POST - Power-On Self Test. The POST process is executed each time the system is powered on. 


Processor Interrupts - Interrupts generated by the CPU processor in response to error conditions or 
processor exceptions. 


Protected Mode - One of the two modes that the CPU can operate in. The Protected mode provides 
virtual memory addressing, in-chip memory management and protection, and task switching to support 
multi-user, multi-tasking system software. 


RAM BIOS - The interface between DOS and the ROM BIOS. It is dynamically loaded at system boot 
with DOS. 


Real Mode - One of the two modes that the CPU can operate in. The Real mode provides compatibility 
with the 8086 family of microprocessors. 


Real-Time Clock - A clock circuit that maintains the correct time whether the system is on or off. The 
real-time clock is powered by both the system power supply and battery. When the system power is 
turned off, the clock continues to operate from the battery. 


Return Status Code - A code returned by the EX-BIOS drivers that indicates the status of the function 
requested. : 


ROM BIOS - The set of EX-BIOS and STD-BIOS drivers. These code modules are contained in the base 
ROM modules on the Processor PCA. 


ROM Module - Code and/or data stored in an EPROM or ROM. 


RS-232C - An Electronic Industries Association (EIA) standard for a serial data transmission interface. 
Often used as a synonym for serial when referring to system ports. 


RTC - Real-Time Clock. 

Scaling - The process of adjusting physical graphics coordinates to fit in a proportionately larger or 
smaller logical space. The Input System scales the coordinates received from a tablet to fit into its logical 
space. 

Scancodes - Codes returned by the physical keyboard to indicate key makes and breaks. 


SDLC - Synchronous Data Link Control. 
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Sector - A physical location on the disc where a block of data is stored. Disc surfaces are divided into 
concentric rings called tracks. These rings are in turn divided into sectors. 


Serial - To transmit data one bit at a time, serially. Used to indicate system ports that transmit data in 
this fashion. See also RS-232C. 


Single Step Interrupt - A processor interrupt generated after each instruction if the Single Step flag is set. 
This interrupt is mapped by the CPU to Interrupt vector 01H. | 


Software Interrupts - Interrupts generated by the CPU INT ’n’ instruction where ’n’ is the interrupt 
number. 


Sprite - A graphics cursor. The sprite is controlled by the Input System V_ STRACK driver. 
SPU - System Processing Unit. 


Stagger - Disc stagger is the track to track offset between logical sectors. Stagger increases disc 
performance during sequential read operations by adjusting for track to track access time. See also 
INTERLEAVE. 


STD-BIOS - The set of drivers that execute the industry standard BIOS functions. 

SYSGEN - System generation process. 

System Software - See Operating System. 

System Strings - Character strings stored in memory. Each EX-BIOS driver has a system string associated 


with it. System strings are designed to provide a simple method for system software to access them. In 
addition, their implementation provides a simple and effective method of localization. 


Tablet - A Graphics Input Device (GID) that generates absolute graphics coordinates. 


Timeout - An indication (for example, an interrupt) that indicates that a predetermined time has elapsed 
waiting for an event to occur. Timeouts are used to prevent the system from hanging up waiting for an 
event to happen that doesn’t. For example, a timeout can be used to abort a print operation if the printer 
does not return a ready status. 


Timer Tick - An interrupt generated by the system timer. It is initialized to produce approximately 18.2 
timer ticks per second. 


Touch Screen - An HP Graphic Input Device (GID). Allows a user to input data by physically touching 
the display screen. 


Track - An Input System driver that moves a Sprite on the display screen in response to graphics motion 
received from GID devices. 


Tracking - The process of moving a Sprite on the display screen in response to graphic motion received 
from GID devices. 


Typematic Delay - The amount of time a key must remain depressed before the keyboard enters the 
typematic or repeat mode. 


Typematic Rate - The rate at which make scancodes are transmitted by the keyboard when it is in the 
typematic or repeat mode. 
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Video Attributes - Video characteristics of characters displayed on the Video Display Adapter. Video 
attributes include reverse video, blinking, underline, and high intensity. Video attributes only apply to 
characters displayed in the alphanumeric modes. 
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This package, which updates the original issue of the Vectra System BIOS Technical Reference Manual, 
provides BIOS update information for the Vectra QS/16, QS/20, RS/20C, and the RS/25C. With the 
replacement of the pages given, the Vectra System BIOS Technical Reference Manual is valid for the HP 
Vectra ES, QS, and RS series of personal computers. (Changes that have been made are explained.) 


All references to the Vectra RS are also valid for the equivalent speed Vectra QS. The only difference 
between the BIOS of the Vectra QS and the BIOS of the Vectra RS is that the QS has a different PC ID 
(identification) flag. See Page B-19 for details. 


Product Kit No. (manual and binder): 45945-60031 
Manual Part No.: 45945-90012 

First Update Part No.. 5959-6796 

Second Update Part No.: 5959-9816 


Personal Computer Group 

974 East Arques Avenue 

P.O. Box 486 

Sunnyvale, CA 94086, U.S.A. 


Insert or replace the update pages in this package in the appropriate chapters of your Vectra System BIOS 
Technical Reference Manual. 
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CHANGE PAGES 


Cover Page 

Second line, under the bar 

Replace: For the HP Vectra Series of Personal Computers 

With: For the HP Vectra Series (ES, QS, RS) of Personal Computers 


Page 1-1 

Paragraph 1, second line 
Replace: ES and RS series 
With: ES, QS, and RS s “1es 


Page 1-1 

Paragraph 2, third line 

Replace: HP Vectra RS series 
With: HP Vectra QS and RS series 


Page 2-1 

Paragraph 1, third line 

Replace: as well as the Vectra ES and RS series discussed 
With: as well as to the HP Vectra series of PCs discussed 


Page 4-39 

Paragraph 2, last line 

REPLACE: all Vectra ES and RS series computers.) 
or REPLACE: all HP Vectra series computers.) 
With: all ES, QS, and RS Vectra series computers.) 


Page 4-47 
Move the last 3 row items in the table, starting with: 
SF__ GET DEVTBL 


SF_ SET__ DEVTBL 


SF DEF DEVTBL 
Between these row items in the table: 
SF CRV REPORT NAME and 


F_ PUT___BYTE 


Page 4-57 

Paragraph 1, second and third lines 

Replace: For the Vectra ES and RS series computers 
With: For the HP Vectra series of computers 
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Page 5-1 

Paragraph |, fourth and fifth lines (in the second bulleted item) 
Replace: used with both the HP Vectra ES and RS series 

With: used with the HP Vectra series 


Page 5-13 
ie 5-7, under sia 


To: jade "Action," stead: ‘of. “anilee "Key Combinations" 


Page 5-13 
Table Ss we under <Ctril>- <Alt>- <+> 





To: under "Action" ea under "Key Combinations" 


Page 5-13 
Table 5-7, within <Ctrl>-<Alt>-< > (across from "This key sequence toggles the computer speed.") 
Add: a backslash ( \ ) to the last part of this "Key Combination." 


Page 5-13 

Table 5-7, across from <Ctrl>-<Alt>-< > 

Replace: On the Vectra RS this is handled by the system BIOS. 
With: On the Vectra QS and RS this is handled by the system BIOS. 


Page 5-13 
Table a= ip under <Shif 
Move: Keyboard/DIN only 


Under: "Action," instead of under "Key Combinations" 





<Print Screen> 





Page 5-14 

Table 5-8, across from F16_ GET EXT__ KEY 
Replace: buffer (Vectra ES and RS keycodes) 

With: buffer (including new Vectra ES, QS, and RS keycodes) 


Page 5-14 

Table 5-8, across from F16_ EXT STATUS 
Replace: Vectra ES and RS keycodes 

With: Vectra ES, QS, and RS keycodes 


Page 5-16 

Paragraph 1, second and third lines 
Replace: Vectra ES and RS series computers. 
With: Vectra series of computers. 


Page 5-16 

Paragraph 2 [starting with F16_ | STATUS (AH=01H)], fifth line 
Replace: HP VEctra ES and RS series 

With: HP Vectra series 
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Page 4-19 

Paragraph 1, second line 

Replace: HP Vectra ES and RS series personal computers 
With. HP Vectra series of computers 


Page 5-19 

Paragraph that starts with AH 
Change spelling of: Concatinated 
To: Concatenated 


Page 5-22 

Within the CAUTION statement 

Replace: "it should be aware that STD-BIOS" 

With: "the programmer should be aware that the EX-BIOS" 


Page 5-26 

Paragraph 1, second line 

Replace: ES and RS series computers 
With: series of computers 


Page 5-26 

Paragraph 3 (starting with "On Exit") 

After the line: BX = OBH for low speed (see following table) 
Add the line: 12H for medium speed (see following table) 


Page 5-26 

Table 5-12 

Replace: table’s title, "HP Vectra ES and RS Speeds" 

With: new table title, "Speeds for HP Vectra Series of Computers" 


Page 5-26 

Table 5-12 

Between: the "High" column heading and the "Low" column heading 
Add: a new column heading, "Medium" 


Page 5-26 
Table 5-12 
Under: the new column heading of "Medium" 
Add, for the first four entries, dashes: " -- " 
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Page 5-26 

Table 5-12, under the column for "Vectra" 
Replace: RS/16 

With: QS/ 16, RS/16 


Page 5-26 

Table 5-12, under the column for "Vectra" 
Replace: RS/20 

With: QS/20, RS/20 


Page 5-26 

Table 5-12 

(1) At the end of the column for "Vectra," add a first new row for: RS/20C 
(2) At the end of the column for "Vectra," add:a second new row for: RS/25C 


Page 5-26 
Table 5-12 
(1) Under the column for "High," and across from RS/20C, add: 20 MHz 
(2) Under the column for "High," and across from RS/25C, add: 25 MHz 


Page 5-26 

Table 5-12 

(1) Under the new column for "Medium," and across from RS/20C, add: 10 MHz 
(2) Under the new column for "Medium," and across from RS/25C, add: 12.5 MHz 


Page 5-26 
Table 5-12 
(1) Under the column for "Low," and across from RS/20C, add: 5 MHz 
(2) Under the column for "Low," and across from RS/25C, add: 5 MHz 


Summary of changes to Table 5-12 appear as follows: 


Table 5~12. Speeds for HP Vectra Series of Computers 


ES/12 
QS/16, RS/16 


QS/20, RS/20 
RS/20C 
RS/25C 
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Page 5-27 

Paragraph 1, first line 

Replace: HP Vectra ES and RS series 
With: HP Vectra series of computers, 


Page 5-27 

Paragraph 1, starting with Fl16_ =GET =INT___ NUMBER (AX = 6FODH) 
After: the last line, "Registers Altered: AX" 

Add the following paragraphs: 


F16_ SET =CACHE___ON (AX = 6FOFH) -- This subfunction enables memory caching. 
On Entry: AX = F16 SET CACHE ON (6FOFH) 
On Exit: AH = OOH (Successful) 
FEH (Cache subsystem is bad) 
Registers Altered: AX 


F16_ SET_. CACHE ___ OFF (AX = 6F10H) -- This subfunction disables memory caching. 
On Entry: AX = F16_ SET CACHE OFF (AX = 6F10H) 

On Exit: AH = OOH (Successful) 

Registers Altered: AX 


F16  GET_ CACHE _ STATE (AX = 6F11H) 
This subfunction returns the memory cache subsystem’s state. 
On Entry: AX = F16__GET__CACHE_STATE (AX = 6F11H) 
On Exit: AH = OOH (Successful) 
AL bit 0 = 0 (Cache Disabled) 
= 1 (Cache Enabled) 
Registers Altered: AX 


F16_ SET = MEDIUM___ SPEED (AX = 6F12H) 

This subfunction sets the computer’s speed to medium. 

On Entry: AX = F16_ SET MEDIUM SPEED (6F 12H) 
On Exit: AH = OOH (Successful) 

Registers Altered: AX 
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Page 5-54 

Table 5-19, across from ODOH, under "Description," 3rd sentence, 
Replace: "See Table 5-22 for bit definitions." 

With: "See Table 5-21 for bit definitions." 


Page 5-54 

Table 5-19, across from ODIH, under "Description," 3rd sentence, 
Replace: "The bit definitions for this port are given in Table 5-22." 
With: "The bit definitions for this port are given in Table 5-21." 


Page 5~59 

Paragraph 3, first and second lines 

Replace: Refer to the Vectra Hardware Technical Reference Manual (for the ES or RS series) 
With: Refer to Figures 5-2 and 5-3 


Page 5-61 

Paragraph 2, first and second lines 

Replace: Refer to the Vectra Hardware Technical Reference Manual (for the ES or RS series) 
With: Refer to Figures 5-2 and 5-3 


Page 5-63 

Paragraph 2, first and second lines 

Replace: Refer to the Vectra Hardware Technical Reference Manual (for the ES or RS series) 
With: Refer to Figures 5-2 and 5-3 


Page 6-3 

Paragraph 1, third line 

Replace: (for either the HP Vectra ES, or RS personal computer) 
With: (for the HP Vectra ES, QS, or RS personal computers). 


Page 6-15 

Paragraph 11, which starts with "Example," first line 
Replace: (AH = 6FO0H) 

With (AX = 6FOOH) 


Page 7-2 

Paragraph 5, (starting with "The flexible disc operation"), fourth lines and following 

Replace: . 

For Vectra RS system, support for two additional flexible discs is achieved with a special Flexible Disc 
Expander card, if you have such a card installed the contents of the operation table are expanded, see 
Tables 7-1 and 7-1a. 


With: 

For the Vectra RS system only, support for two additional flexible discs is achieved with a special Flexible 
Disc Expander card. (If this card is installed, the contents of the operation table are expanded.) See 
Tables 7-1 and 7-1la. 
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Page 8-1 

Paragraph 4, first line 

- Replace: (double word on Vectra RS series) 
With: (double word on Vectra QS and RS series) 


Page 8-8 
Half-way through page 
: FOR HP VECTRA | RS SERIES COMPUTERS 
Pp. 5 SERIES. COMPUTERS 






Page 8 8 

Two-thirds through page 

Replace: On Exit: EAX = Double word with all equipment information. 

With: On Exit: EAX = Double word with all equipment information. (* Indicates for Vectra RS only.) 


Page 8-8 

In: the table under EAX = Double word with all equipment information 
Replace throughout: Weitek 1167 

With: Weitek 1167* 


Page 8-18 

3rd line from the bottom 

Replace: OFFH = Printer, timeout required. 
With: OFEH = Printer, timeout required. 


Page 9-3 

Second-to-last bulleted item 

Replace: Test the coprocessor if present (80387 and Weitek coprocessor for Vectra RS series). 

With: Test the coprocessor if present (80387 for Vectra QS series, and 80387 and Weitek coprocessor for 
Vectra RS series). 


Page 9-3 
After: the sixth bulleted item, "Test the first 64 KB of system RAM." 
Include: a new bulleted item, “Test memory cache subsystem (Vectra RS/20C and RS/25C.)" 


Page 9-3 
Before: the last bulleted item, “Test serial and parallel port (parallel port not tested in Vectra RS series)." 
Include: a new bulleted item, "Test the CPU clock speed.” 


Page 9-3 

Change: the last bulleted item 

From: "Test serial and parallel port (parallel port not tested in Vectra RS series)." 
To: "Test serial port." 
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Reorder the bulleted items so they have the following order: 


OOM A AWN! H 


. Initialize the video display for diagnostic messages. 

. Test the operation of the CPU. 

. Test the system ROM. 

. Test and initialize 8254 timer/counter and start the refresh counter. 

. Test and initialize DMA controllers and DMA page registers. 

. Test the first 64 KB of system RAM. 

. Test memory cache subsystem (Vectra RS/20C and RS/25C only.) 

. Test and initialize the 8259A interrupt controllers. 

. Test the 8042 controller and Scandoor. 

. Test the HP-HIL controller. 

. Test CMOS RAM for integrity. 

. Determine if manufacturing electronic tool is present. If so, run manufacturing test. 
. Test the remaining base system RAM (RAM above the first 64 KB). 

. Test the extended RAM above memory address 100000H (protected mode RAM.) 

. Test the real-time clock portion of the RTC/CMOS chip. 

. Test the keyboard interface and the keyboard itself. 

. Test the flexible disc controller subsystem. 

18. 


Test the coprocessor if present (80287 for Vectra ES series, 80387 for Vectra QS series, and 80387 


and Weitek coprocessor for Vectra RS series). 19. Test the CPU clock speed. 


20. 


Test serial port. 


Page 9-3 
Summary -- the bulleted items will now appear as follows: 


Test the operation of the CPU. 

Test the system ROM. 

Test and initialize 8254 timer/counter and start the refresh counter. 

Test the first 64 KB of system RAM. 

Test memory cache subsystem (Vectra RS/20C and RS/25C only.) 

Initialize the video display for diagnostic messages. 

Test and initialize DMA controllers and DMA page registers. 

Test and initialize the 8259A interrupt controllers. 

Test the 8042 controller and Scandoor. 

Test the HP-HIL controller. 

Test CMOS RAM for integrity. 

Determine if manufacturing electronic tool is present. If so, run manufacturing test. 
Test the remaining base system RAM (RAM above the first 64 KB). 

Test the extended RAM above memory address 100000H (protected mode RAM.) 
Test the real-time clock portion of the RTC/CMOS chip. 

Test the keyboard interface and the keyboard itself. 

Test the flexible disc controller subsystem. 

Test the coprocessor if present (80287 for Vectra ES series, 80387 for Vectra QS series, and 80387 
and Weitek coprocessor for Vectra RS series). 

Test the CPU clock speed. 

Test serial port. 


Page 9-3 

Last line of page 

Replace: (for Vectra RS series). 
With: (for Vectra QS and RS series). 
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Pages 9-4 to 9-9 





Pages 9-10 to 9-15 
Title of Table 9-2b 


S § 





Pages 9-10 to 9-15 
Delete: entire column entitled "Chip" and all entries underneath 


Page 9-11 

Table 9-2b. 

After row for: 0709 

Include this row information: 

Code: 070B 

Test: 82C301 

Description: CPU clock too slow at MEDIUM speed. 


Page 9-11 

Table 9-2b. 

After new row for: 070B 

Include this row information: 

Code: 070C 

Test: 82C301 

Description: CPU clock too fast at MEDIUM speed. 


Page 9-15 

Table 9-2b, thoughout, under the "Description" column 
Replace: Weitek 

With: Weitek * 


Page 9-15 

Across from: "AFOO" and "Weitek" 

Under the column: Description 

Change: Weitek coprocessor (COP) Test failed to enter Protected Mode. . 

To: Weitek* coprocessor (COP) Test failed to enter Protected Mode. (* indicates for Vectra RS only.) 
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Page 9-15 

Table 9-2b 

After: row for AFOC | 

Add: the following row information for B300 through BFFF: 


Code: B300 
Test: 8042 ** 
Description: Failed to switch to protected mode. (** indicates errors detected by the Memory Cache Test.) 


Code: B301-B307 
Test: 82385 
Description: General cache subsystem failure. 


Code: B400-B7FF 

Test: Main Memory ** 

Description: Read/write test of DRAM locations 60000h-6FFFFh failed. 
Decode bits in error code to isolate failing memory module: 

BX YZ where 

X = Olaa => aa specifies which byte is bad (0-3) 

YZ = bbbb bbbb => b=1 specifies bad bit 

e.g.: 0100 0010 => bits 6 and 1 bad 


Code: B800-BBFF 

Test: Static RAM 

Description: Read/write test of SRAM failed. 
Decode bits in error code to isolate failing chips: 
BXYZ where 

X = 10aa => aa specifies which byte is bad (0 - 3) 
YZ = bbbb bbbb => b=1 specifies bad bit 

e.g.: 0100 0010 => bits 6 and 1 bad 


Code: BCOO-BFFF 

Test: Static RAM 

Description: Marching ones test of SRAM failed. 
Decode bits in error code to isolate failing chips: 
BXYZ where 

X = |laa => aa specifies which byte is bad (0 - 3) 
YZ = bbbb bbbb => b=! specifies bad bit 

e.g.: 0100 0010 => bits 6 and 1 bad 
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Page 9-15/9-16 

First sentence after Table 9-2b, starting with "If the POST process is initiated.. " 

Replace: "If the POST process is initiated by a soft reset, the RAM tests are not executed." 

With: “If the POST process is initiated by a soft reset, the RAM tests and the cache memory test are not 
executed." 


Page 9-19 

Paragraph 4, starting with "Shadow RAM." Title, and first and fourth lines 
Replace: HP Vectra RS 

With: HP Vectra QS and RS 


Page A-6 

Table A-2 

Across from: INT Hex code 16H 

Add: the following row information after the row for Function Value 02H -- 


Function Value: 03H 
Function Equate: F16 SET TYPE RATE 
Definition: Set typematic rates. 


Function Value: 05H 
Function Equate: F16 PUT KEY 


Definition: Put data into keyboard buffer. 


Function Value: 10H 
Function Equate: F116 =GET EXT 
Definition: Read keycode from buffer (including extended keycodes). 


Function Value: 11H 
Function Equate: F16 EXT STATUS 
Definition: Report extended keyboard status 


Function Value: 12H 
Function Equate: F16 EXT KEY STATE 


Definition: Get Extended Key Modifier status. 


Page A-6 

Table A-2. 

Across from: INT Hex code 17H 

For: the Function Value 6FO1H 

Change: the Function Equate, "F17__ READ _ STATUS" 
To: a blank line 
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Page A-6 

Table A-2. 

Across from: INT Hex code 17H 

For: the Function Value 6F03H 

Change: the Function Equate, "F 17__ GET___ BUFFER" 
To: a blank line 


Page A-6 

Table A-2. 

Across from: INT Hex code 17H 
After: the Function Value 6F04H 
Add: the following row information -- 


Function Value: 6FOFH 
Function Equate: F16 SET CACHE ON 
Definition: Turn cache on. 


Function Value: 6F10H 
Function Equate: F16 SET CACHE OFF 


Definition: Turn cache off. 


Function Value: 6F11H 
Function Equate: F16 GET CACHE STATE 
Definition: Get current cache state. 


Function Value: 6F12H 
Function Equate: F16 SET MEDIUM SPEED 


Definition: Sets medium speed for cache machines. 


Page A-15 
Table A-3 
Delete the following rows of information: 


0114H 04/16 SF_KEYBOARD_ REPEAT Set typematic values 


0114H 04/18 SF_KEYBOARD LED Set keyboard LED states 

0114H 06 F_PUT_ BYTE Write one byte to specified HP-HIL device 
Page A-15 

Table A-3 

In the place of the deleted rows above, include the following rows of information: 

Vector Func. Function Definition 

Address Value Equate 

0114H 04/20 SF_GET_ DEVTBL Gets physical device table address 
0114H 04/22 SF_SET_DEVTBL Sets physical device table address 
0114H 04/24 SF_DEF_DEVTBL Sets default physical device table 
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Page B-13 
Under: Flexible Disc Expander Adapter Data Area 


Replace: 
This is only applicable in Vectra RS systems with the Flexible Disc Expander adapter card installed. 


With: 
This applies solely to the Vectra RS systems, and only when the Flexible Disc Expander adapter card 1s 
installed. 


Page B-15 

Item f, first line 

Replace: HP Vectra ES and RS series computers 
With: HP Vectra series of computers 


Page B-15 

Item f, fourth and fifth lines 

Replace: RAM in the Vectra ES and RS computers 
With: RAM in the Vectra series of computers 


Page B-15 

Item f, last line 

Replace: of the Vectra RS 
With: of the Vectra QS and RS 


Page B-19 

Top of page 

Replace: table title, "Vectra ES and RS Series Processor Clock Rates" 

With: new title, "Processor Clock Rates for HP Vectra Series of Computers" 


Page B-19 

Table at top of page, under the column for "Computer" 
Replace: Vectra RS/16 

With: Vectra QS/16, RS/16 


Page B-19 

Table at top of page, under the column for "Computer" 
Replace: Vectra RS/20 

With: Vectra QS/20, RS/20 


Page B-19 
Table at top of page, 
Add: two new rows ~-- 


Vectra RS/20C 14H (20 MHz) O5H (5 MHz) 
Vectra RS/25C “19H (25 MHz) OSH (5 MHz) 
Page B-19 


Table at top of page, under the column for "Clock Rate (High)" 
Replace: OCH (8 MHz) 
With: OCH (12 MHz) 
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Summary: New table on page B-19 appears as follows -- 


Processor Clock Rates for HP Vectra Series of Computers 


































Vectra ES O8H (8 MHz) O8H (8&8 MHz) 
Vectra ES/12 OCH (12 MHz) O8H (8 MHz) 
Vectra QS/16, RS/16 10H (16 MHz) O8H (8 MHz) 
Vectra QS/20, RS/20 14H (20 MHz) O8H (8 MHz) 
Vectra RS/20C 14H (20 MHz) OSH (5S MHz) | 
Vectra RS/25C OSH (5S MHz) 


19H (25 MHz) 
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Page B-19 


As shown in the update below, 
after the PC ID for the Vectra RS/16 00110 


add the 
add the 
add the 
add the 
add the 


PC 
PC 
PC 
PC 


ID for the Vectra QS/16 
ID for the Vectra QS/20 
ID for the Vectra RS/20C 
ID for the Vectra RS/25C 
ID for the Vectra LS/12 


Also, on the next line, 


Change: 00111 through 11111 - Reserved 


00111 
01000 
01001 
01010 
01011 


or change: 01001 through 11111 - Reserved 
To: 01100 through 11111 - Reserved 


Bits: 


16 


01100 through 11111 


000 
001 
010 
011 


100 through 111 
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Original Vectra PC 
Vectra ES/12 
Vectra RS/20 
Portable Vectra CS 
Vectra ES 

Vectra CS 

Vectra RS/16 
Vectra QS/16 
Vectra QS/20 
Vectra RS/20C 
Vectra RS/25C 
Vectra LS/12 
Reserved 


80286 
8088 
8086 
80386 
Reserved 


Page B-19 
Move: Paragraph entitled "Machine Capability Marker" 
To: Page B-20 


Page B-20 

Move: Paragraph entitled "Year of the ROM BIOS Release (in BCD)" 
and: Paragraph entitled "Week of the ROM BIOS Release (in BCD)" 
To: Page B-21 


(ADD: NEW page B-21) 


Page C-6 

2nd to last line 

Replace: Note that Vectra ES and RS series computer 
With: Note that Vectra series of personal computers 


Page D-1 
Paragraph 1, last two lines 


Replace: Vectra Accessories Technical Reference Manual (for either the Vectra ES or RS series). 


With: Vectra Accessories Technical Reference Manual 


Page F-2 

Last line 

Replace: HP Vectra ES and RS 

With: HP Vectra series of personal computers 


Page F-3 

Paragraph 3 (starting with "This code"), first line 
Replace: HP Vectra ES and RS series 

With: HP Vectra series of personal computers 


Page F-3 

Paragraph 3, second and third lines 

Replace: unique features of the HP Vectra ES and RS series. This method 

With: unique features of the HP Vectra series of personal computers. (However, this method 


Page F-20 

Paragraph 3 (starting with "The driver is"), fourth line 
Replace: all Vectra ES and RS series 

With: all Vectra series 


Update Notice - March 1989 


17 


Page Glossary 2 

Coprocessor, second line 

Replace: The 80287 (Vectra ES), 80387 and Weitek coprocessor (Vectra RS only) are 

With: The 80287 (Vectra ES), the 80387 (Vectra QS and RS), and the Weitek coprocessor (Vectra RS 
only) are 


Page Glossary 5 

Original Vectra PC, first line 

Replace: Vectra ES and RS series 

With: Vectra ES, QS, and RS series 

Index 

Insert: Cache 5-27, 9-3, 9-15, 9-16, A-6 
Delete: "Disk (see Disc)" 


Replace: Machine Capability Marker B-19 
With: Machine Capability Marker B-20 


Replace: Week of BIOS Release B-20 
With: Week of BIOS Release B-21 


Replace: Year of BIOS Release B-20 
With: Year of BIOS Release B-21 
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